Skip to main content
PUT
Update an agent

Authorizations

Authorization
string
header
required

A VisIQ API key presented as Authorization: Bearer vq_prod_.... Mint keys under Connectors -> API Keys in the dashboard.

Path Parameters

id
string<uuid>
required

The agent's row UUID (not the human-readable agent_id).

Body

application/json
name
string
Required string length: 1 - 255
description
string
Maximum string length: 1000
mode
enum<string> | null
Available options:
enforce,
monitor,
off,
null
mode_by_operation
object | null

Per-operation mode overrides (any subset of the three keys).

owner_email
string<email> | null
Maximum string length: 320
hitl_pathway
enum<string> | null
Available options:
slack,
teams,
email,
null
trust_tier
string | null
categories
string[]
business_function
string | null

One of the closed business-function ids.

business_functions
string[]
business_function_source
enum<string>
Available options:
ai,
user
no_coverage
enum<string> | null
Available options:
open,
closed,
null

Response

The updated agent.

id
string<uuid>
agent_id
string
name
string
description
string | null
mode
enum<string> | null
Available options:
enforce,
monitor,
off,
null
mode_by_operation
object | null

Per-operation mode overrides (any subset of the three keys).

owner_email
string | null
hitl_pathway
string | null
agent_os
string | null
agent_hostname
string | null
agent_ip
string | null
agent_username
string | null
trust_tier
string | null
categories
string[] | null
business_function
string | null
business_functions
string[] | null
business_function_source
string | null
no_coverage
string | null
created_at
string<date-time>
updated_at
string<date-time>