Citera home
Browse documentation

Brands and capabilities

Brands and capabilities

Discover bound brands and enabled capabilities.

Summarize with AIChatGPTClaudePerplexity

GET /v1/brands

Brands bound to the key and still owned by its user (read via RLS). Query: limit, cursor, status (active|frozen), domain (exact match). Returns brand objects, newest first.

GET /v1/brands/{brand_id}

One brand including its capabilities summary.

GET /v1/brands/{brand_id}/capabilities

Scopes (any): brands:read, prompts:read, visibility:read, recommendations:read, content:read, integrations:read.

Returns brand_capabilities:

  • resource_families — families your key's scopes unlock (prompt_library,
    scan_runs, visibility, recommendations, content, integrations,
    jobs, calendar, results, website, local, images);

  • capabilities.content_generation — true when the brand is not frozen,
    api.generation.enabled is on, and the key holds an enrolled content:generate;

  • capabilities.publishing — the same for publishing:write, plus at least one
    healthy destination;

  • content_types — GENERATION_CONTENT_TYPES if the key can generate;

  • destinations — sanitized integrations (only with integrations:read).

Call this before any write to learn what is possible.