Update an agent

Partial update. Send only the fields you want to change, omitted fields stay unchanged. Honors Idempotency-Key.

Scope: agents:write

Path parameters

Request body

Any subset of the create body fields, plus:

Side effects of is_active toggle

Flipping is_active isn't just a flag, it cascades:

• Triggers: deactivating the agent deactivates all of its triggers. Activating reactivates them. Zendesk webhooks are soft-toggled in place (status flipped on Zendesk's side) rather than torn down and recreated, so the webhook ID that the customer's own Zendesk Triggers reference is preserved.
• Chatbots: any chatbot bound to this agent is paused/resumed.

Example: deactivate an agent

curl -X PATCH https://dashboard.getmacha.com/api/v1/agents/agent_64f1c0... \
  -H "Authorization: Bearer $MACHA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "is_active": false }'

Example: move an agent to a different model

curl -X PATCH https://dashboard.getmacha.com/api/v1/agents/agent_64f1c0... \
  -H "Authorization: Bearer $MACHA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{ "model": "gpt-5.4" }'

Example: replace the tool list entirely

curl -X PATCH https://dashboard.getmacha.com/api/v1/agents/agent_64f1c0... \
  -H "Authorization: Bearer $MACHA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tools": [
      { "name": "zendesk_get_ticket",       "connector_id": "connector_..." },
      { "name": "zendesk_update_priority",  "connector_id": "connector_..." }
    ]
  }'

Passing tools replaces the whole array, there's no PATCH-style "add this tool" or "remove this tool" today. Read the agent first, then send the desired final array.

Errors