Skip to main content
POST
Create a delegation grant

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
parent_agent_id
string
required
Required string length: 1 - 255
child_agent_id
string
required
Required string length: 1 - 255
tool_scope
string[] | null

Allowlist of tools the child may use. null = unrestricted; [] = deny-all.

Minimum string length: 1
context_scope
string[] | null
Minimum string length: 1
purpose
string
Maximum string length: 2000
duration_seconds
integer
default:3600
Required range: 1 <= x <= 604800
max_depth
integer
Required range: 1 <= x <= 16
parent_grant_token
string | null

Response

The pending grant.

grant_id
string
status
enum<string>
Available options:
pending
effective_tool_scope
string[] | null
effective_context_scope
string[] | null
accept_deadline
string<date-time>