Update an Agent

curl --request PATCH \
  --url https://api.getarbol.com/v1/agents/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "language": "<string>"
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({language: '<string>'})
};

fetch('https://api.getarbol.com/v1/agents/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.getarbol.com/v1/agents/{id}"

payload = { "language": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "createdAt": "2026-08-29T14:30:00Z",
  "description": "<string>",
  "id": "agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31",
  "kind": "voice",
  "language": "<string>",
  "name": "Asistente de ventas",
  "profile": {
    "greeting": "<string>",
    "channelKind": "voice",
    "settings": {
      "availableLanguages": [
        "<string>"
      ],
      "conversationalBehavior": {
        "backgroundSound": {
          "crossfadeLoop": true,
          "presetId": "office1",
          "volume": 0.6
        },
        "backgroundVoiceDetection": false,
        "expressiveMode": false,
        "interruptionIgnoreTerms": [],
        "keywords": [],
        "maxDurationMessage": "<string>",
        "maxDurationSeconds": 600,
        "mergeDefaultIgnoreTerms": false,
        "retranscribeOnTurnTimeout": false,
        "silenceEndCallTimeoutSeconds": 20,
        "speculativeTurn": false,
        "spellingPatience": "auto",
        "transcribeOnDisabledInterruptions": false,
        "turnEagerness": "normal",
        "turnModel": "turn_v3",
        "turnTimeoutSeconds": 7
      },
      "disableFirstMessageInterruptions": true,
      "greetingTranslations": [
        {
          "language": "<string>",
          "text": "<string>"
        }
      ],
      "humanTransfers": [
        {
          "condition": "<string>",
          "phoneNumber": "+573001234567",
          "transferType": "conference"
        }
      ],
      "intelligence": {
        "backupLlm": {
          "mode": "default",
          "order": []
        },
        "cascadeTimeoutSeconds": 4,
        "llm": "gpt-5.6-luna",
        "maxTokens": -1,
        "parallelToolCalls": false,
        "reasoningEffort": "none",
        "reasoningSummary": false,
        "softTimeout": {
          "enabled": false,
          "message": "",
          "seconds": 3
        },
        "temperature": 0.7
      },
      "toolConfigs": [
        {
          "config": {
            "endCallDescription": "<string>",
            "endCallReasons": [
              "farewell"
            ]
          },
          "isEnabled": true,
          "type": "END_CALL"
        }
      ],
      "voiceConfigs": [
        {
          "language": "<string>",
          "settings": {
            "similarity": 0.8,
            "speed": 1,
            "stability": 0.5
          },
          "voiceId": "<string>",
          "label": "<string>"
        }
      ]
    }
  },
  "prompt": "<string>",
  "status": "active",
  "timezone": "America/Bogota",
  "updatedAt": "2026-08-29T14:30:00Z",
  "isRunnable": true,
  "knowledgeDocumentIds": [
    "agt_018f47a2-4f4d-7d61-9e2c-1d7b8e9a0c31"
  ],
  "toolAccess": {
    "entries": [
      {
        "connectedAccountId": "<string>",
        "tools": [
          {
            "key": "google-calendar.create-event"
          }
        ]
      }
    ],
    "revision": 4503599627370495
  }
}

{
  "defined": true,
  "inferable": true,
  "code": "BAD_REQUEST",
  "status": 400,
  "message": "<string>",
  "data": {
    "issues": [
      {
        "code": "custom",
        "message": "<string>",
        "path": [
          "<string>"
        ]
      }
    ],
    "truncated": true
  }
}

{
  "defined": true,
  "inferable": true,
  "code": "UNAUTHORIZED",
  "status": 401,
  "message": "<string>",
  "data": "<unknown>"
}

{
  "defined": true,
  "inferable": true,
  "code": "FORBIDDEN",
  "status": 403,
  "message": "<string>",
  "data": {
    "missingPermissions": [
      "agents:read"
    ]
  }
}

{
  "defined": true,
  "inferable": true,
  "code": "NOT_FOUND",
  "status": 404,
  "message": "<string>",
  "data": "<unknown>"
}

{
  "defined": true,
  "inferable": true,
  "code": "CONFLICT",
  "status": 409,
  "message": "<string>",
  "data": {
    "currentRevision": 4503599627370495
  }
}

{
  "code": "PAYLOAD_TOO_LARGE",
  "defined": false,
  "inferable": false,
  "message": "<string>",
  "data": "<unknown>"
}

{
  "code": "UNSUPPORTED_MEDIA_TYPE",
  "defined": false,
  "inferable": false,
  "message": "<string>",
  "data": "<unknown>"
}

{
  "defined": true,
  "inferable": true,
  "code": "UNPROCESSABLE_CONTENT",
  "status": 422,
  "message": "<string>",
  "data": {
    "reason": "primary_voice_missing"
  }
}

{
  "defined": true,
  "inferable": true,
  "code": "TOO_MANY_REQUESTS",
  "status": 429,
  "message": "<string>",
  "data": {
    "retryAfterSeconds": 123
  }
}

{
  "defined": true,
  "inferable": true,
  "code": "SERVICE_UNAVAILABLE",
  "status": 503,
  "message": "<string>",
  "data": {
    "code": "COMPOSIO_FAILURE",
    "message": "The integration operation could not be completed.",
    "retryable": false,
    "data": {
      "reason": "integration_tool_unavailable",
      "statusCode": 349
    }
  }
}