# Archestra AI Agents API

**Canonical:** https://apis.io/apis/archestra/archestra-agents-api/  
**Provider:** Archestra AI — https://apis.io/providers/archestra/  
**Documentation:** https://archestra.ai/docs/reference/api

Archestra AI Agents API is one of 74 APIs that [Archestra AI](https://apis.io/providers/archestra/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Agents API from Archestra AI — 48 operation(s) for agents.

## Operations (60 of 67)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/agent-catalog` | Get agent catalog |
| GET | `/api/agents` | Get agents |
| POST | `/api/agents` | Create agent |
| PUT | `/api/agents/{id}/pin` | Pin agent |
| DELETE | `/api/agents/{id}/pin` | Unpin agent |
| GET | `/api/agents/all` | Get all agents |
| GET | `/api/agents/chat-roster` | Get chat agent roster |
| GET | `/api/agents/chat-roster/page` | Get chat agent roster page |
| GET | `/api/agents/options` | Get agent options |
| GET | `/api/agents/options/page` | Get agent options page |
| GET | `/api/agents/options/ids` | Get agent option ids |
| GET | `/api/agents/credential-readiness` | Get agent credential readiness |
| POST | `/api/agents/import` | Import agent |
| GET | `/api/agents/{id}` | Get agent |
| PUT | `/api/agents/{id}` | Update agent |
| DELETE | `/api/agents/{id}` | Delete agent |
| GET | `/api/agents/{id}/default-suggested-prompts` | Get agent default suggested prompts |
| GET | `/api/agents/{id}/versions` | Get agent versions |
| GET | `/api/agents/{id}/versions/{version}` | Get agent version |
| POST | `/api/agents/{id}/versions/{version}/restore` | Restore agent version |
| POST | `/api/agents/{id}/clone` | Clone agent |
| GET | `/api/agents/{id}/export` | Export agent |
| GET | `/api/agents/{id}/mcp-tool-preview` | Get agent mcp tool preview |
| GET | `/api/agents/{id}/tool-exclusions` | Get agent tool exclusions |
| PUT | `/api/agents/{id}/tool-exclusions` | Update agent tool exclusions |
| GET | `/api/agents/{id}/subagent-exclusions` | Get agent subagent exclusions |
| PUT | `/api/agents/{id}/subagent-exclusions` | Update agent subagent exclusions |
| GET | `/api/agents/{id}/knowledge-source-exclusions` | Get agent knowledge source exclusions |
| PUT | `/api/agents/{id}/knowledge-source-exclusions` | Update agent knowledge source exclusions |
| GET | `/api/agents/activation-skills` | Get agent activation skills |
| GET | `/api/agents/{id}/activation-skill-policy` | Get agent activation skill policy |
| PATCH | `/api/agents/{id}/activation-skill-policy` | Patch agent activation skill policy |
| GET | `/api/agents/{id}/skills` | Get agent skills |
| PUT | `/api/agents/{id}/skills` | Update agent skills |
| GET | `/api/agents/{id}/skill-exclusions` | Get agent skill exclusions |
| PUT | `/api/agents/{id}/skill-exclusions` | Update agent skill exclusions |
| POST | `/api/agents/{id}/transfer-ownership` | Transfer agent ownership |
| DELETE | `/api/agents/bulk` | Bulk delete agents |
| POST | `/api/agents/{id}/restore` | Restore agent |
| DELETE | `/api/agents/{id}/permanent` | Permanently delete agent |
| GET | `/api/agents/labels/keys` | Get label keys |
| GET | `/api/agents/labels/values` | Get label values |
| GET | `/api/agent-runs/{taskId}/workspace/files` | Read agent workspace file |
| PUT | `/api/agent-runs/{taskId}/workspace/files` | Write agent workspace file |
| DELETE | `/api/agent-runs/{taskId}/workspace` | Delete agent workspace |
| GET | `/api/agents/{id}/runtime/preflight` | Get agent runtime preflight |
| GET | `/api/agents/{id}/runtime/claude-code/account` | Get claude code account |
| POST | `/api/agents/{id}/runtime/claude-code/account` | Start claude code sign in |
| DELETE | `/api/agents/{id}/runtime/claude-code/account` | Disconnect claude code account |
| POST | `/api/agents/{id}/runtime/claude-code/account/complete` | Complete claude code sign in |
| GET | `/api/agents/{id}/runtime/claude-code/models` | Get claude code models |
| PUT | `/api/agents/{id}/runtime/credentials/{key}` | Set agent runtime credential |
| DELETE | `/api/agents/{id}/runtime/credentials/{key}` | Delete agent runtime credential |
| GET | `/api/agents/{id}/runs` | Get agent runs |
| POST | `/api/agents/{id}/runs` | Start agent run |
| GET | `/api/agent-runs` | Get my agent runs |
| GET | `/api/agent-runs/{taskId}` | Get my agent run |
| PATCH | `/api/agent-runs/{taskId}` | Update agent run |
| DELETE | `/api/agent-runs/{taskId}` | Delete agent run |
| GET | `/api/agent-runs/{taskId}/openappa-review` | Get agent run openappa review |

…and 7 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/archestra/openapi/archestra-agents-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/archestra/json-schema/archestra-gemini-generate-content-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/archestra/json-schema/archestra-gemini-generate-content-request-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/archestra/json-schema/archestra-minimax-chat-completion-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/archestra/json-schema/archestra-minimax-chat-completion-request-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/archestra/json-schema/archestra-openrouter-chat-completion-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/archestra/json-schema/archestra-perplexity-chat-completion-request-schema.json

## Other Archestra AI APIs (12)

- [Archestra AI A2A API](https://apis.io/apis/archestra/archestra-a2a-api/)
- [Archestra AI Agent Delegations API](https://apis.io/apis/archestra/archestra-agent-delegations-api/)
- [Archestra AI Agent Tools API](https://apis.io/apis/archestra/archestra-agent-tools-api/)
- [Archestra AI API Keys API](https://apis.io/apis/archestra/archestra-api-keys-api/)
- [Archestra AI App Gallery API](https://apis.io/apis/archestra/archestra-app-gallery-api/)
- [Archestra AI App Recordings API](https://apis.io/apis/archestra/archestra-app-recordings-api/)
- [Archestra AI Apps API](https://apis.io/apis/archestra/archestra-apps-api/)
- [Archestra AI Audit Log API](https://apis.io/apis/archestra/archestra-audit-log-api/)
- [Archestra AI Auth API](https://apis.io/apis/archestra/archestra-auth-api/)
- [Archestra AI Browser Storage States API](https://apis.io/apis/archestra/archestra-browser-storage-states-api/)
- [Archestra AI Chat API](https://apis.io/apis/archestra/archestra-chat-api/)
- [Archestra AI Chat Ops API](https://apis.io/apis/archestra/archestra-chatops-api/)

## Tags

Agents

---

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