> ## Documentation Index > Fetch the complete documentation index at: https://docs.aiybiz.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a published use case ## OpenAPI ````yaml /api-reference/openapi.json get /use-cases/{slug} openapi: 3.1.0 info: title: Atako API version: 0.1.0 description: >- The Atako customer API — manage AI agents, their files, integrations, billing, and your company/team, programmatically. ## Authentication Every non-public endpoint takes a Bearer token that is either: - a **programmatic API key** (`aik_…`) — create one at [app.atako.ai](https://app.atako.ai) → Settings → API keys (company-admin only), or - a **Supabase session JWT** — what the web app itself sends; not practical to obtain outside a browser session. ```bash curl https://api.atako.ai/agents -H "Authorization: Bearer aik_..." ``` An API key acts as its owning user, with all of that user's permissions — there is no separate key scope in this release. ## Other Atako HTTP surfaces (not covered by this spec) - **Atako MCP server** — `POST /mcp` (auth: same Bearer token as above) exposes a read-only Model Context Protocol tool catalogue for AI clients (Claude Code, Claude Desktop, Cursor, ChatGPT). See [docs.atako.ai/developers/mcp/overview](https://docs.atako.ai/developers/mcp/overview). - **Content API** (`cak_…` key, `/content/*`) — a separate, more restricted key type for headless CMS-style access to blog/news/use-case content. Not documented here. ## Errors Errors use a JSON envelope: `{ "error": string, "code"?: string }`. `error` is either a short human-readable message or a SCREAMING_SNAKE_CASE code, depending on the route — treat it as an opaque string to match against, not a stable enum across the whole API. ## Rate limits Authenticated routes: 6000 requests/min per user (`authRateLimit`). Public GET routes: 60/min per IP. A handful of sensitive public POST routes (newsletter signup, email-exists, invitation preview) are limited to 10 requests / 15 min per IP. ## Pagination List endpoints use either simple `limit`/`offset` query params (marketing content — a plain JSON array response, capped at the documented max) or `page`/`limit` (credit transactions). Neither returns a total count today; fetch until a page comes back shorter than `limit`. servers: - url: https://api.atako.ai description: Production security: [] tags: - name: Agents - name: Messages - name: Activity - name: Agent Options - name: API Keys - name: Files - name: Cron Jobs - name: Sub-Agents - name: Interagent Messages - name: Integrations - name: Subscriptions - name: Users - name: Company - name: Teams - name: Public - name: Marketing Content paths: /use-cases/{slug}: get: tags: - Marketing Content summary: Get a published use case operationId: getUseCase parameters: - name: slug in: path required: true description: Use case slug schema: type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/UseCase' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/Error' security: [] components: schemas: UseCase: type: object properties: id: type: string format: uuid slug: type: string department: type: string enum: - sales - marketing - finance - support - hr - it - engineering - product - design title: type: object description: >- A French base value plus optional translations. `fr` is always present; other IETF locale keys are present when translated. properties: fr: type: string en: type: string de: type: string es: type: string it: type: string pt-BR: type: string nl: type: string pl: type: string sv: type: string da: type: string tr: type: string ja: type: string ko: type: string required: - fr additionalProperties: type: string description: type: object description: >- A French base value plus optional translations. `fr` is always present; other IETF locale keys are present when translated. properties: fr: type: string en: type: string de: type: string es: type: string it: type: string pt-BR: type: string nl: type: string pl: type: string sv: type: string da: type: string tr: type: string ja: type: string ko: type: string required: - fr additionalProperties: type: string aeoQuestion: type: object description: >- A French base value plus optional translations. `fr` is always present; other IETF locale keys are present when translated. properties: fr: type: string en: type: string de: type: string es: type: string it: type: string pt-BR: type: string nl: type: string pl: type: string sv: type: string da: type: string tr: type: string ja: type: string ko: type: string required: - fr additionalProperties: type: string aeoAnswer: type: object description: >- A French base value plus optional translations. `fr` is always present; other IETF locale keys are present when translated. properties: fr: type: string en: type: string de: type: string es: type: string it: type: string pt-BR: type: string nl: type: string pl: type: string sv: type: string da: type: string tr: type: string ja: type: string ko: type: string required: - fr additionalProperties: type: string toolsV2: type: array items: type: object properties: name: type: object description: >- A French base value plus optional translations. `fr` is always present; other IETF locale keys are present when translated. properties: fr: type: string en: type: string de: type: string es: type: string it: type: string pt-BR: type: string nl: type: string pl: type: string sv: type: string da: type: string tr: type: string ja: type: string ko: type: string required: - fr additionalProperties: type: string description: type: object description: >- A French base value plus optional translations. `fr` is always present; other IETF locale keys are present when translated. properties: fr: type: string en: type: string de: type: string es: type: string it: type: string pt-BR: type: string nl: type: string pl: type: string sv: type: string da: type: string tr: type: string ja: type: string ko: type: string required: - fr additionalProperties: type: string integrationSlug: type: string workflowAgentSteps: type: object description: Same shape as LocalizedText, but each locale holds a string array. properties: fr: type: array items: type: string required: - fr additionalProperties: type: array items: type: string workflowHumanSteps: type: object description: Same shape as LocalizedText, but each locale holds a string array. properties: fr: type: array items: type: string required: - fr additionalProperties: type: array items: type: string faqV2: type: array items: type: object properties: question: type: object description: >- A French base value plus optional translations. `fr` is always present; other IETF locale keys are present when translated. properties: fr: type: string en: type: string de: type: string es: type: string it: type: string pt-BR: type: string nl: type: string pl: type: string sv: type: string da: type: string tr: type: string ja: type: string ko: type: string required: - fr additionalProperties: type: string answer: type: object description: >- A French base value plus optional translations. `fr` is always present; other IETF locale keys are present when translated. properties: fr: type: string en: type: string de: type: string es: type: string it: type: string pt-BR: type: string nl: type: string pl: type: string sv: type: string da: type: string tr: type: string ja: type: string ko: type: string required: - fr additionalProperties: type: string coverImage: type: string nullable: true tags: type: array items: type: string publishedAt: type: string format: date-time nullable: true createdAt: type: string format: date-time updatedAt: type: string format: date-time required: - id - slug - department - title - description Error: type: object description: >- Atako's standard error envelope. `error` is either a short human-readable message or a SCREAMING_SNAKE_CASE code (routes are inconsistent about which — treat it as an opaque string and match on it exactly if you need to branch on error type). Some routes add extra fields alongside `error` (see the operation's own error responses). properties: error: type: string code: type: string description: >- Present on some routes; a stable machine-readable code duplicating or refining `error`. required: - error additionalProperties: true ````