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