Stop an emitter · dogabot docs

post https://api.dogabot.com/api/v1/emitters/{id}/stop

Stops an owned emitter. REST-only; not available as an MCP tool. Requires the listed write scope and feat:api:write on an Institutional account. Send Idempotency-Key.

Scopes write:lifecycle write

Path parameters

id integer required

Example 42

Headers

Idempotency-Key string required

Unique key per mutation so retries stay safe.

Example retry-1

Responses

200 OK

401 Unauthorized

403 Forbidden — missing scope or feature gate

404 Not found

429 Rate limited

Request

Bash Request

curl -X POST 'https://api.dogabot.com/api/v1/emitters/42/stop' \
  -H "Authorization: Bearer $DOGABOT_API_KEY" \
  -H 'Idempotency-Key: retry-1'

Python Request

import os
import requests

resp = requests.request(
    "POST",
    "https://api.dogabot.com/api/v1/emitters/42/stop",
    headers={"Authorization": f"Bearer {os.environ['DOGABOT_API_KEY']}", "Idempotency-Key": "retry-1"},
    timeout=30,
)
resp.raise_for_status()
print(resp.json())

JavaScript Request

const res = await fetch("https://api.dogabot.com/api/v1/emitters/42/stop", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.DOGABOT_API_KEY}`,
    "Idempotency-Key": "retry-1",
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
console.log(await res.json());

Go Request

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("POST", "https://api.dogabot.com/api/v1/emitters/42/stop", nil)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("DOGABOT_API_KEY"))
	req.Header.Set("Idempotency-Key", "retry-1")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	out, _ := io.ReadAll(resp.Body)
	fmt.Println(resp.Status, string(out))
}

Response

JSON OK

{
  "message": "emitter 1001 stopping"
}

JSON Unauthorized

{
  "error": "unauthorized"
}

Text Forbidden — missing scope or feature gate

Forbidden — missing scope or feature gate

Text Not found

Not found

Text Rate limited

Rate limited