Skip to content
MentionBird.ai
Browse the documentation

Change Prompts' AI Platforms

Add or remove AI platforms on prompts. Removals apply first, so the prompt runs they free count toward the additions in the same call. In a workspace already over its prompt-run limit, a note says how many added pairs won't run until runs free up. Requires a write-enabled API key.

POST /prompts/llms

Request body

Send as application/json. This endpoint needs a write-enabled API key.

Field Type Description
brand required string Tracked brand name.
brand_prompt_ids required array of string Prompt ID tokens from listQueries. Allowed: 1–200 items.
add_llms array of string Platform slugs to add (see getAccount). Allowed: up to 5 items.
remove_llms array of string Platform slugs to remove. Allowed: up to 5 items.

Example request

curl -X POST -H "Authorization: Bearer $MENTIONBIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "brand": "Acme",
  "brand_prompt_ids": [
    "openai"
  ]
}' \
  "https://api.mentionbird.ai/api/v1/prompts/llms"

Responses

200
Done. The body reports the outcome for each item.
400
Validation error — check the message in `error.message`.
401
Unauthorized — missing, invalid or revoked bearer token.
403
Forbidden — the plan lacks API access, the key is read-only, or addTrackedBrand would pass the tracked-brand limit.
404
Not found — the brand, prompt or resource does not exist.
405
Method not allowed.
429
Too many requests — over the key's per-minute or per-day limit. Wait the seconds in the `Retry-After` header, then retry.
500
Internal error — logged; retry is safe for reads.