v4

OpenAPI 3.0.0MIT2026-07-311554531.6 MB
Agents

Update an agent integration

Update which integration a link points to (by integration identifier, not the internal _id).

patch/v1/agents/{identifier}/integrations/{agentIntegrationId}

Path parameters

identifierstring required
agentIntegrationIdstring required

Request body

integrationIdentifierstring required

The integration identifier this link should point to (not the internal document _id).

Response

OK

_idstring required

Agent–integration link document id.

_agentIdstring required
_environmentIdstring required
_organizationIdstring required
connectedAtobject nullable

Set when the agent–integration link received its first inbound webhook delivery.

createdAtstring required
updatedAtstring required
exceedsPlanLimitboolean

Cloud only. true when this channel type (provider) falls outside the organization plan active-channel limit (by connection order). Active channels are counted per channel type, so multiple integrations of the same provider (e.g. several Slack workspaces) count as a single active channel. Over-limit channels keep their configuration but the agent will not respond on them until the plan is upgraded or older channel types are disconnected.