Update an agent
Agents
Update an agent
Partially update an agent. Setting mode to null clears the per-agent override so it inherits the account default. At least one field is required. Requires permission allow_agents:update.
PUT
Update an agent
Authorizations
A VisIQ API key presented as Authorization: Bearer vq_prod_.... Mint keys under Connectors -> API Keys in the dashboard.
Path Parameters
The agent's row UUID (not the human-readable agent_id).
Body
application/json
Required string length:
1 - 255Maximum string length:
1000Available options:
enforce, monitor, off, null Per-operation mode overrides (any subset of the three keys).
Maximum string length:
320Available options:
slack, teams, email, null One of the closed business-function ids.
Available options:
ai, user Available options:
open, closed, null Response
The updated agent.
Available options:
enforce, monitor, off, null Per-operation mode overrides (any subset of the three keys).