Skip to main content
PATCH
/
v1
/
agents
/
{agentId}
Update an agent
curl --request PATCH \
  --url https://api.devic.ai/v1/agents/{agentId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "imgUrl": "<string>",
  "assistantSpecialization": {
    "identifier": "<string>",
    "name": "<string>",
    "description": "<string>",
    "presets": "<string>",
    "availableToolsGroupsUids": [
      "<string>"
    ],
    "enabledTools": [
      "<string>"
    ],
    "model": "<string>",
    "provider": "<string>",
    "imgUrl": "<string>",
    "codeSnippetIds": [
      "<string>"
    ],
    "availableSkillIds": [
      "<string>"
    ],
    "subagentsIds": [
      "<string>"
    ],
    "maxChatMessages": 123,
    "maxToolResponseInputTokens": 123
  },
  "disabled": true,
  "archived": true,
  "provider": "<string>",
  "llm": "<string>",
  "maxExecutionInputTokens": 123,
  "maxExecutionToolCalls": 123,
  "agentNotificationConfig": {
    "enabled": true,
    "enableEmailNotification": true,
    "notifiedEmails": [
      "<string>"
    ],
    "approvalEmails": [
      "<string>"
    ]
  },
  "evaluationConfig": {
    "enabled": true,
    "customCriteria": [
      {}
    ],
    "disableDefaultEvaluation": true
  }
}
'
{
  "_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "imgUrl": "<string>",
  "disabled": true,
  "archived": true,
  "provider": "<string>",
  "llm": "<string>",
  "assistantSpecialization": {
    "identifier": "<string>",
    "name": "<string>",
    "description": "<string>",
    "presets": "<string>",
    "availableToolsGroupsUids": [
      "<string>"
    ],
    "enabledTools": [
      "<string>"
    ],
    "model": "<string>",
    "provider": "<string>",
    "imgUrl": "<string>",
    "codeSnippetIds": [
      "<string>"
    ],
    "availableSkillIds": [
      "<string>"
    ],
    "subagentsIds": [
      "<string>"
    ],
    "maxChatMessages": 123,
    "maxToolResponseInputTokens": 123
  },
  "creationTimestampMs": 123,
  "lastEditTimestampMs": 123,
  "maxExecutionInputTokens": 123,
  "maxExecutionToolCalls": 123,
  "agentNotificationConfig": {},
  "evaluationConfig": {}
}

Authorizations

Authorization
string
header
required

Use JWT token for authentication

Path Parameters

agentId
string
required

The unique identifier of the agent to update

Body

application/json
name
string

Agent name

description
string

Agent description

imgUrl
string

Image URL for the agent

assistantSpecialization
object

Configuration for the assistant specialization

disabled
boolean

Whether the agent is disabled

archived
boolean

Whether the agent is archived

provider
string

LLM provider override

llm
string

LLM model name override

maxExecutionInputTokens
integer

Maximum input tokens per execution

maxExecutionToolCalls
integer

Maximum tool calls per execution

agentNotificationConfig
object
evaluationConfig
object

Response

Agent updated successfully

_id
string

Agent ID

name
string

Agent name

description
string

Agent description

imgUrl
string

Image URL

disabled
boolean

Whether the agent is disabled

archived
boolean

Whether the agent is archived

provider
string

LLM provider

llm
string

LLM model name

assistantSpecialization
object

Configuration for the assistant specialization

creationTimestampMs
integer

Creation timestamp in milliseconds

lastEditTimestampMs
integer

Last edit timestamp in milliseconds

maxExecutionInputTokens
integer

Maximum input tokens per execution

maxExecutionToolCalls
integer

Maximum tool calls per execution

agentNotificationConfig
object
evaluationConfig
object