ARartil
Agents

Update an agent

Rename an agent, change its icon or turn on its secrets.

patch/agents/{id}

Request

  • Base URL
    https://app.artil.ai/api
  • URL
    https://app.artil.ai/api/agents/{id}
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://mcp.artil.ai/oauth/authorize
      Token URL: https://mcp.artil.ai/oauth/token scopes: agent

Path parameters

idstring uuid required

The agent's id

Request body

namestring
icon'bot' | 'sparkles' | 'bug' | 'message-square' | 'headphones' | 'search' | 'file-text' | 'mail' | 'calendar' | 'chart-line' | 'code' | 'git-pull-request' | 'database' | 'shield' | 'megaphone' | 'rocket' | 'wrench' | 'zap'
secretsEnabledtrue

Turn on the agent's secrets; once on, they stay on

Response

The changed agent

idstring uuid required
namestring required
icon'bot' | 'sparkles' | 'bug' | 'message-square' | 'headphones' | 'search' | 'file-text' | 'mail' | 'calendar' | 'chart-line' | 'code' | 'git-pull-request' | 'database' | 'shield' | 'megaphone' | 'rocket' | 'wrench' | 'zap' required
secretsEnabledboolean required

Whether the agent can save and use secrets; a person turns them on

createdAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.