# Atako API API

**Canonical:** https://apis.io/apis/atako-ai/atako-api-api/  
**Provider:** Atako — https://apis.io/providers/atako-ai/  
**Base URL:** https://api.atako.ai  
**Documentation:** https://atako.ai/en/developers

Atako API API is one of 2 APIs that [Atako](https://apis.io/providers/atako-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Atako customer API — manage AI agents, their files, integrations, billing, and your company/team, programmatically.

## Operations (60 of 319)

| Method | Path | Summary |
|---|---|---|
| GET | `/agents` | List your agents |
| POST | `/agents` | Create an agent |
| GET | `/agents/{id}` | Get agent detail |
| POST | `/agents/{id}/cancel` | Cancel a provisioning agent |
| POST | `/agents/{id}/retry-provisioning` | Retry a failed provisioning |
| POST | `/agents/{id}/end` | End an active agent |
| POST | `/agents/{id}/resume` | Resume a paused agent |
| GET | `/agents/{id}/export` | Export everything an agent holds, as a JSON attachment |
| GET | `/agents/{id}/upgrade-status` | Check whether an engine upgrade is available |
| POST | `/agents/{id}/upgrade` | Trigger an in-place engine image upgrade |
| PATCH | `/agents/{id}/name` | Set the agent's display name |
| PATCH | `/agents/{id}/role` | Set or clear the agent's job title |
| PATCH | `/agents/{id}/finish` | Set or clear the agent's 3D body finish (« skin ») |
| PATCH | `/agents/{id}/instructions` | Edit the agent's mission, instructions and business context |
| PATCH | `/agents/{id}/team` | Move the agent to a team, or make it personal |
| PATCH | `/agents/{id}/model` | Change the LLM model of a live agent |
| PATCH | `/agents/{id}/llm-key` | Reassign the agent's BYOK LLM key |
| GET | `/agents/{agentId}/conversations` | List the caller's chat sessions with an agent |
| POST | `/agents/{agentId}/conversations` | Open a new chat session with an agent |
| POST | `/agents/{agentId}/conversations/archive` | Archive or un-archive several chat sessions at once |
| GET | `/conversations/{id}` | One chat session |
| PATCH | `/conversations/{id}` | Rename, archive or un-archive a chat session |
| GET | `/agents/{agentId}/messages` | List an agent's chat messages |
| POST | `/agents/{agentId}/messages` | Send a chat message to the agent |
| POST | `/agents/{agentId}/turns/steer` | Add an instruction to the agent's running turn |
| POST | `/agents/{agentId}/turns/stop` | Stop the agent's running turn |
| POST | `/agents/{agentId}/messages/{messageId}/flag` | Flag a message as an error (deprecated — recorded as a thumbs down, use PUT …/feedback) |
| PUT | `/agents/{agentId}/messages/{messageId}/feedback` | Thumbs up / down an agent reply (replaces any previous verdict) |
| DELETE | `/agents/{agentId}/messages/{messageId}/feedback` | Remove your thumbs up / down from an agent reply (idempotent) |
| GET | `/agents/{agentId}/events` | SSE stream of new messages and live-activity events |
| GET | `/agents/{agentId}/activity` | Live-activity feed history |
| GET | `/agents/{agentId}/activity/state` | Current working/idle state |
| GET | `/agents/{agentId}/turns/{turnId}/sources` | Knowledge items an agent read during one turn |
| GET | `/models` | List visible AI models (for the create-agent form) |
| GET | `/models/catalog` | List the whole OpenRouter catalog with Atako flags |
| GET | `/models/recent` | Models the caller's company already launched agents on |
| GET | `/models/favorites` | List the starred model slugs (company-wide) |
| PUT | `/models/favorites` | Star or unstar one model for the whole company |
| GET | `/harnesses` | List visible harnesses (for the create-agent form) |
| GET | `/agent-engines` | List runtime engines and the default used when creating an agent |
| GET | `/users/api-keys` | List the company's programmatic API keys |
| POST | `/users/api-keys` | Create an API key |
| DELETE | `/users/api-keys/{id}` | Revoke an API key |
| DELETE | `/users/api-keys/{id}/permanent` | Permanently delete an already-revoked API key |
| GET | `/company/audit-log` | List the company audit journal |
| GET | `/company/audit-log/export` | Export the company audit journal as CSV |
| GET | `/agents/{id}/files` | List files an agent can access (granted files + its dedicated folder) |
| GET | `/agents/{id}/files/{nodeId}/download-url` | Get a signed download URL for a file accessible to the agent |
| GET | `/client/files` | List the company drive |
| GET | `/client/files/usage` | Total size and file count of the drive you can see |
| POST | `/client/files/folders` | Create a folder |
| POST | `/client/files/nodes` | Create a file node (before uploading) |
| PATCH | `/client/files/{nodeId}` | Rename and/or move a file or folder |
| DELETE | `/client/files/{nodeId}` | Delete a file or folder (recursive) |
| POST | `/client/files/{nodeId}/upload-url` | Get a signed upload URL for a file node |
| GET | `/client/files/{nodeId}/download-url` | Get a signed download URL for a file node |
| POST | `/client/files/{nodeId}/complete-upload` | Finalize an upload |
| GET | `/agents/{agentId}/file-grants` | List client files granted to an agent |
| POST | `/agents/{agentId}/file-grants` | Grant client files to an agent |
| DELETE | `/agents/{agentId}/file-grants/{grantId}` | Revoke a file grant |

…and 259 more operations. The page lists the first 250; the full set of 319 is in the OpenAPI linked below.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/atako-ai/openapi/_original/atako-ai-api-openapi.json
- **JSONSchema** — https://artifacts.apis.io/atako-ai/json-schema/atako-ai-use-case-schema.json
- **JSONSchema** — https://artifacts.apis.io/atako-ai/json-schema/atako-ai-integration-page-schema.json
- **JSONSchema** — https://artifacts.apis.io/atako-ai/json-schema/atako-ai-site-banner-schema.json
- **JSONSchema** — https://artifacts.apis.io/atako-ai/json-schema/atako-ai-agent-record-schema.json
- **JSONSchema** — https://artifacts.apis.io/atako-ai/json-schema/atako-ai-company-subscription-schema.json
- **JSONSchema** — https://artifacts.apis.io/atako-ai/json-schema/atako-ai-create-agent-body-schema.json

## Other Atako APIs (1)

- [Atako API](https://apis.io/apis/atako-ai/atako-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/atako-ai/atako-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/atako-ai/.