format: md

Agents API

SDK managed-agents. Conjunto de APIs para gerenciar agentes persistentes, vaults de credenciais, armazenamento de memória, skills e perfis de usuário.

format: md

Agents API

Beta: managed-agents-2026-04-01

format: md

POST /v1/agents

POST /v1/agents

Cria um novo agente.

Header	Valor	Obrigatório
`Authorization`	`Bearer <token>`	Sim
`anthropic-beta`	`managed-agents-2026-04-01`	Sim

Response (201):

{
  "id": "agent_abc"
}

Exemplo curl:

curl -X POST http://localhost:4000/v1/agents \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-beta: managed-agents-2026-04-01" \
  -d '{}'

Códigos de Erro: 400, 401, 403, 500

format: md

GET /v1/agents/`{agent_id}`

GET /v1/agents/{agent_id}

Obtém detalhes de um agente.

Parâmetro Path	Tipo	Descrição
`agent_id`	string	ID do agente

Response:

{
  "id": "agent_abc"
}

Exemplo curl:

curl -X GET "http://localhost:4000/v1/agents/agent_abc" \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-beta: managed-agents-2026-04-01"

Códigos de Erro: 401, 403, 404, 500

format: md

POST /v1/agents/

POST /v1/agents/

Atualiza um agente existente.

Parâmetro Path	Tipo	Descrição
`agent_id`	string	ID do agente

Códigos de Erro: 400, 401, 403, 404, 500

format: md

GET /v1/agents

GET /v1/agents

Lista todos os agentes.

Exemplo curl:

curl -X GET "http://localhost:4000/v1/agents" \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-beta: managed-agents-2026-04-01"

Códigos de Erro: 401, 403, 500

format: md

POST /v1/agents//archive

POST /v1/agents//archive

Arquiva um agente.

Parâmetro Path	Tipo	Descrição
`agent_id`	string	ID do agente

Códigos de Erro: 401, 403, 404, 409, 500

format: md

GET /v1/agents/`{agent_id}`/versions

GET /v1/agents/{agent_id}/versions

Lista as versões de configuração de um agente.

Parâmetro Path	Tipo	Descrição
`agent_id`	string	ID do agente

Códigos de Erro: 401, 403, 404, 500

format: md

Vaults API

Beta: managed-agents-2026-04-01

format: md

POST /v1/vaults

POST /v1/vaults

Cria um novo vault para armazenamento seguro de credenciais.

Header	Valor	Obrigatório
`Authorization`	`Bearer <token>`	Sim
`anthropic-beta`	`managed-agents-2026-04-01`	Sim

Códigos de Erro: 400, 401, 403, 500

format: md

GET /v1/vaults/

GET /v1/vaults/

Obtém detalhes de um vault.

Parâmetro Path	Tipo	Descrição
`vault_id`	string	ID do vault

Códigos de Erro: 401, 403, 404, 500

format: md

POST /v1/vaults/`{vault_id}`

POST /v1/vaults/{vault_id}

Atualiza um vault existente.

Parâmetro Path	Tipo	Descrição
`vault_id`	string	ID do vault

Códigos de Erro: 400, 401, 403, 404, 500

format: md

GET /v1/vaults

GET /v1/vaults

Lista todos os vaults.

Exemplo curl:

curl -X GET "http://localhost:4000/v1/vaults" \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-beta: managed-agents-2026-04-01"

Códigos de Erro: 401, 403, 500

format: md

DELETE /v1/vaults/`{vault_id}`

DELETE /v1/vaults/{vault_id}

Remove permanentemente um vault.

Parâmetro Path	Tipo	Descrição
`vault_id`	string	ID do vault

Códigos de Erro: 401, 403, 404, 500

format: md

POST /v1/vaults//archive

POST /v1/vaults//archive

Arquiva um vault.

Parâmetro Path	Tipo	Descrição
`vault_id`	string	ID do vault

Códigos de Erro: 401, 403, 404, 409, 500

format: md

POST /v1/vaults/`{vault_id}`/credentials

POST /v1/vaults/{vault_id}/credentials

Cria uma nova credencial dentro de um vault.

Parâmetro Path	Tipo	Descrição
`vault_id`	string	ID do vault

Códigos de Erro: 400, 401, 403, 404, 500

format: md

GET /v1/vaults//credentials

GET /v1/vaults//credentials

Lista credenciais de um vault.

Parâmetro Path	Tipo	Descrição
`vault_id`	string	ID do vault

Códigos de Erro: 401, 403, 404, 500

format: md

GET /v1/vaults/`{vault_id}`/credentials/`{cred_id}`

GET /v1/vaults/{vault_id}/credentials/{cred_id}

Obtém detalhes de uma credencial específica.

Parâmetro Path	Tipo	Descrição
`vault_id`	string	ID do vault
`cred_id`	string	ID da credencial

Códigos de Erro: 401, 403, 404, 500

format: md

POST /v1/vaults//credentials/

POST /v1/vaults//credentials/

Atualiza uma credencial.

Parâmetro Path	Tipo	Descrição
`vault_id`	string	ID do vault
`cred_id`	string	ID da credencial

Códigos de Erro: 400, 401, 403, 404, 500

format: md

DELETE /v1/vaults/`{vault_id}`/credentials/`{cred_id}`

DELETE /v1/vaults/{vault_id}/credentials/{cred_id}

Remove uma credencial.

Parâmetro Path	Tipo	Descrição
`vault_id`	string	ID do vault
`cred_id`	string	ID da credencial

Códigos de Erro: 401, 403, 404, 500

format: md

Memory Stores API

Beta: managed-agents-2026-04-01

format: md

POST /v1/memory_stores

POST /v1/memory_stores

Cria um novo memory store.

Header	Valor	Obrigatório
`Authorization`	`Bearer <token>`	Sim
`anthropic-beta`	`managed-agents-2026-04-01`	Sim

Códigos de Erro: 400, 401, 403, 500

format: md

GET /v1/memory_stores/

GET /v1/memory_stores/

Obtém detalhes de um memory store.

Parâmetro Path	Tipo	Descrição
`store_id`	string	ID do memory store

Códigos de Erro: 401, 403, 404, 500

format: md

POST /v1/memory_stores/`{store_id}`

POST /v1/memory_stores/{store_id}

Atualiza um memory store.

Parâmetro Path	Tipo	Descrição
`store_id`	string	ID do memory store

Códigos de Erro: 400, 401, 403, 404, 500

format: md

GET /v1/memory_stores

GET /v1/memory_stores

Lista todos os memory stores.

Exemplo curl:

curl -X GET "http://localhost:4000/v1/memory_stores" \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-beta: managed-agents-2026-04-01"

Códigos de Erro: 401, 403, 500

format: md

DELETE /v1/memory_stores/`{store_id}`

DELETE /v1/memory_stores/{store_id}

Remove permanentemente um memory store.

Parâmetro Path	Tipo	Descrição
`store_id`	string	ID do memory store

Códigos de Erro: 401, 403, 404, 500

format: md

POST /v1/memory_stores//archive

POST /v1/memory_stores//archive

Arquiva um memory store.

Parâmetro Path	Tipo	Descrição
`store_id`	string	ID do memory store

Códigos de Erro: 401, 403, 404, 409, 500

format: md

POST /v1/memory_stores/`{store_id}`/memories

POST /v1/memory_stores/{store_id}/memories

Cria uma nova memória em um memory store.

Parâmetro Path	Tipo	Descrição
`store_id`	string	ID do memory store

Códigos de Erro: 400, 401, 403, 404, 500

format: md

GET /v1/memory_stores//memories/

GET /v1/memory_stores//memories/

Obtém uma memória específica.

Parâmetro Path	Tipo	Descrição
`store_id`	string	ID do memory store
`memory_id`	string	ID da memória

Códigos de Erro: 401, 403, 404, 500

format: md

POST /v1/memory_stores/`{store_id}`/memories/`{memory_id}`

POST /v1/memory_stores/{store_id}/memories/{memory_id}

Atualiza uma memória existente.

Parâmetro Path	Tipo	Descrição
`store_id`	string	ID do memory store
`memory_id`	string	ID da memória

Códigos de Erro: 400, 401, 403, 404, 500

format: md

GET /v1/memory_stores//memories

GET /v1/memory_stores//memories

Lista memórias de um memory store.

Parâmetro Path	Tipo	Descrição
`store_id`	string	ID do memory store

Códigos de Erro: 401, 403, 404, 500

format: md

DELETE /v1/memory_stores/`{store_id}`/memories/`{memory_id}`

DELETE /v1/memory_stores/{store_id}/memories/{memory_id}

Remove uma memória.

Parâmetro Path	Tipo	Descrição
`store_id`	string	ID do memory store
`memory_id`	string	ID da memória

Códigos de Erro: 401, 403, 404, 500

format: md

Skills API

Beta: skills-2025-10-02

format: md

POST /v1/skills

POST /v1/skills

Cria uma nova skill.

Header	Valor	Obrigatório
`Authorization`	`Bearer <token>`	Sim
`anthropic-beta`	`skills-2025-10-02`	Sim

Códigos de Erro: 400, 401, 403, 500

format: md

GET /v1/skills/

GET /v1/skills/

Obtém detalhes de uma skill.

Parâmetro Path	Tipo	Descrição
`skill_id`	string	ID da skill

Códigos de Erro: 401, 403, 404, 500

format: md

GET /v1/skills

GET /v1/skills

Lista todas as skills.

Exemplo curl:

curl -X GET "http://localhost:4000/v1/skills" \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-beta: skills-2025-10-02"

Códigos de Erro: 401, 403, 500

format: md

DELETE /v1/skills/

Remove uma skill.

Parâmetro Path	Tipo	Descrição
`skill_id`	string	ID da skill

Códigos de Erro: 401, 403, 404, 500

format: md

POST /v1/skills/`{skill_id}`/versions

POST /v1/skills/{skill_id}/versions

Cria uma nova versão de skill.

Parâmetro Path	Tipo	Descrição
`skill_id`	string	ID da skill

Códigos de Erro: 400, 401, 403, 404, 500

format: md

GET /v1/skills//versions/

GET /v1/skills//versions/

Obtém uma versão específica de skill.

Parâmetro Path	Tipo	Descrição
`skill_id`	string	ID da skill
`version_id`	string	ID da versão

Códigos de Erro: 401, 403, 404, 500

format: md

GET /v1/skills/`{skill_id}`/versions

GET /v1/skills/{skill_id}/versions

Lista versões de uma skill.

Parâmetro Path	Tipo	Descrição
`skill_id`	string	ID da skill

Códigos de Erro: 401, 403, 404, 500

format: md

User Profiles API

Beta: user-profiles-2026-03-24

format: md

POST /v1/user_profiles

POST /v1/user_profiles

Cria um perfil de usuário.

Header	Valor	Obrigatório
`Authorization`	`Bearer <token>`	Sim
`anthropic-beta`	`user-profiles-2026-03-24`	Sim

Códigos de Erro: 400, 401, 403, 500

format: md

GET /v1/user_profiles/

GET /v1/user_profiles/

Obtém detalhes de um perfil.

Parâmetro Path	Tipo	Descrição
`profile_id`	string	ID do perfil

Códigos de Erro: 401, 403, 404, 500

format: md

POST /v1/user_profiles/`{profile_id}`

POST /v1/user_profiles/{profile_id}

Atualiza um perfil de usuário.

Parâmetro Path	Tipo	Descrição
`profile_id`	string	ID do perfil

Códigos de Erro: 400, 401, 403, 404, 500

format: md

GET /v1/user_profiles

GET /v1/user_profiles

Lista todos os perfis de usuário.

Exemplo curl:

curl -X GET "http://localhost:4000/v1/user_profiles" \
  -H "Authorization: Bearer $ANTHROPIC_API_KEY" \
  -H "anthropic-beta: user-profiles-2026-03-24"

Códigos de Erro: 401, 403, 500

format: md

POST /v1/user_profiles/`{profile_id}`/enrollment_url

POST /v1/user_profiles/{profile_id}/enrollment_url

Gera uma URL de enrollment para um perfil de usuário (ex.: convite para onboarding).

Parâmetro Path	Tipo	Descrição
`profile_id`	string	ID do perfil

Response:

{
  "enrollment_url": "https://anthropic.com/enroll/abc123"
}

Códigos de Erro: 401, 403, 404, 500

Agents API​

POST /v1/agents​

GET /v1/agents/&#123;agent_id&#125;​

POST /v1/agents/​

GET /v1/agents​

POST /v1/agents//archive​

GET /v1/agents/&#123;agent_id&#125;/versions​

Vaults API​

POST /v1/vaults​

GET /v1/vaults/​

POST /v1/vaults/&#123;vault_id&#125;​

GET /v1/vaults​

DELETE /v1/vaults/&#123;vault_id&#125;​

POST /v1/vaults//archive​

POST /v1/vaults/&#123;vault_id&#125;/credentials​

GET /v1/vaults//credentials​

GET /v1/vaults/&#123;vault_id&#125;/credentials/&#123;cred_id&#125;​

POST /v1/vaults//credentials/​

DELETE /v1/vaults/&#123;vault_id&#125;/credentials/&#123;cred_id&#125;​

Memory Stores API​

POST /v1/memory_stores​

GET /v1/memory_stores/​

POST /v1/memory_stores/&#123;store_id&#125;​

GET /v1/memory_stores​

DELETE /v1/memory_stores/&#123;store_id&#125;​

POST /v1/memory_stores//archive​

POST /v1/memory_stores/&#123;store_id&#125;/memories​

GET /v1/memory_stores//memories/​

POST /v1/memory_stores/&#123;store_id&#125;/memories/&#123;memory_id&#125;​

GET /v1/memory_stores//memories​

DELETE /v1/memory_stores/&#123;store_id&#125;/memories/&#123;memory_id&#125;​

Skills API​

POST /v1/skills​

GET /v1/skills/​

GET /v1/skills​

DELETE /v1/skills/​

POST /v1/skills/&#123;skill_id&#125;/versions​

GET /v1/skills//versions/​

GET /v1/skills/&#123;skill_id&#125;/versions​

User Profiles API​

POST /v1/user_profiles​

GET /v1/user_profiles/​

POST /v1/user_profiles/&#123;profile_id&#125;​

GET /v1/user_profiles​

POST /v1/user_profiles/&#123;profile_id&#125;/enrollment_url​

Agents API

POST /v1/agents

GET /v1/agents/`{agent_id}`

POST /v1/agents/

GET /v1/agents

POST /v1/agents//archive

GET /v1/agents/`{agent_id}`/versions

Vaults API

POST /v1/vaults

GET /v1/vaults/

POST /v1/vaults/`{vault_id}`

GET /v1/vaults

DELETE /v1/vaults/`{vault_id}`

POST /v1/vaults//archive

POST /v1/vaults/`{vault_id}`/credentials

GET /v1/vaults//credentials

GET /v1/vaults/`{vault_id}`/credentials/`{cred_id}`

POST /v1/vaults//credentials/

DELETE /v1/vaults/`{vault_id}`/credentials/`{cred_id}`

Memory Stores API

POST /v1/memory_stores

GET /v1/memory_stores/

POST /v1/memory_stores/`{store_id}`

GET /v1/memory_stores

DELETE /v1/memory_stores/`{store_id}`

POST /v1/memory_stores//archive

POST /v1/memory_stores/`{store_id}`/memories

GET /v1/memory_stores//memories/

POST /v1/memory_stores/`{store_id}`/memories/`{memory_id}`

GET /v1/memory_stores//memories

DELETE /v1/memory_stores/`{store_id}`/memories/`{memory_id}`

Skills API

POST /v1/skills

GET /v1/skills/

GET /v1/skills

DELETE /v1/skills/

POST /v1/skills/`{skill_id}`/versions

GET /v1/skills//versions/

GET /v1/skills/`{skill_id}`/versions

User Profiles API

POST /v1/user_profiles

GET /v1/user_profiles/

POST /v1/user_profiles/`{profile_id}`

GET /v1/user_profiles

POST /v1/user_profiles/`{profile_id}`/enrollment_url