Skip to main content
PATCH
/
v2
/
agents
/
{agent_id}
Update Agent
curl --request PATCH \
  --url https://api.duvo.ai/v2/agents/{agent_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "slack_enabled": true,
  "microsoft_teams_enabled": true,
  "agentic_memory_enabled": true,
  "thread_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "pinned": true
}
'
{
  "agent": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>",
    "slack_enabled": true,
    "microsoft_teams_enabled": true,
    "agentic_memory_enabled": true,
    "team_id": "<string>",
    "thread_id": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>",
    "last_run_at": "<string>",
    "latest_build": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "copilot_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "config": {
        "data": {
          "model": "<string>",
          "tools": "<unknown>",
          "input": "<string>",
          "files": [],
          "skills": [],
          "temperature": 1,
          "max_output_tokens": 1,
          "top_p": 0.5,
          "store": true,
          "text": {
            "format": {}
          }
        }
      },
      "status": "<string>",
      "revision_number": 123,
      "parent_build_id": "<string>",
      "created_by": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "revision_name": "<string>",
      "revision_description": "<string>",
      "created_by_name": "<string>",
      "schedules": [
        {
          "id": "<string>",
          "build_id": "<string>",
          "agent_id": "<string>",
          "user_id": "<string>",
          "enabled": true,
          "time": "<string>",
          "timezone": "<string>",
          "day": "<string>",
          "day_of_month": 123,
          "cron": "<string>",
          "source": "<string>",
          "task": "<string>",
          "recurring": true,
          "created_at": "<string>",
          "updated_at": "<string>",
          "user_name": "<string>",
          "user_email": "<string>"
        }
      ]
    },
    "integration_configs": [
      {
        "id": "<string>",
        "integration_id": "<string>",
        "integration_type": "<string>",
        "integration_name": "<string>",
        "created_at": "<string>",
        "icon_url": "<string>",
        "is_connected": true
      }
    ],
    "folder_id": "<string>",
    "pinned_at": "<string>",
    "created_by": {
      "id": "<string>",
      "name": "<string>",
      "email": "<string>"
    },
    "updated_by": {
      "id": "<string>",
      "name": "<string>",
      "email": "<string>"
    },
    "user_triggers": {
      "slack_mention": true,
      "slack_channel": true,
      "teams_mention": true
    },
    "case_trigger_enabled": true,
    "case_trigger_has_conflict": true,
    "case_trigger_conflicting_agents": [
      {
        "id": "<string>",
        "name": "<string>"
      }
    ],
    "case_queue_name": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

​
agent_id
string<uuid>
required

The agent's unique identifier

Body

application/json
​
name
string

New agent display name.

​
slack_enabled
boolean

Whether the agent is reachable via Slack.

​
microsoft_teams_enabled
boolean

Whether the agent is reachable via Microsoft Teams.

​
agentic_memory_enabled
boolean

Toggle agentic memory for the agent.

​
thread_id
string<uuid> | null

Thread id to associate with the agent, or null to clear.

​
pinned
boolean

Pin the agent to the top of the team's assignment list (true) or unpin it (false).

Response

Default Response

​
agent
object
required