Skip to main content
POST
Create an approval request

Authorizations

Authorization
string
header
required

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

Body

application/json
agent_id
string
required
Required string length: 1 - 255
action
string
required
Required string length: 1 - 255
target_app
string
default:openclaw
Required string length: 1 - 255
context
object
reason
string
Required string length: 1 - 1000
category
enum<string>
default:engineer
Available options:
enduser,
engineer,
finance,
security,
compliance,
other
rule_code
string
Required string length: 1 - 64
timeout_seconds
integer
default:120
Required range: 10 <= x <= 120

Response

The created queue item.

id
string<uuid>
decision_id
string<uuid> | null
agent_id
string
target_app
string
action
string
context
object
category
enum<string>
Available options:
enduser,
engineer,
finance,
security,
compliance,
other
status
enum<string>
Available options:
pending,
approved,
rejected,
timeout,
expired,
dismissed,
resolved
notified_via
string[] | null
expires_at
string<date-time> | null
responded_at
string<date-time> | null
responded_by
string | null
created_at
string<date-time>