Delegations

Update a delegation

Update delegation tools, limits, mode, or active status. Human-only.

patch/v1/agents/{agent_id}/delegations/{delegation_id}

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/agents/{agent_id}/delegations/{delegation_id}
  • Auth: HTTP bearer

Path parameters

agent_idstring uuid required
delegation_idstring uuid required

Request body

allowed_toolsstring[]
blocked_toolsstring[]
max_daily_delegationsinteger
max_depthinteger
guardrailsobject
delegation_mode'caller' | 'target' | 'both'
is_activeboolean
expires_atstring date-time nullable

Response

Delegation updated

idstring uuid
org_idstring uuid
delegator_idstring uuid
delegate_idstring uuid
delegator_namestring
delegate_namestring
allowed_toolsstring[]
blocked_toolsstring[]
max_daily_delegationsinteger nullable
max_depthinteger
guardrailsobject
delegation_mode'caller' | 'target' | 'both'
is_activeboolean
created_bystring uuid
expires_atstring date-time nullable
created_atstring date-time
updated_atstring date-time
delegations_todayinteger

Number of delegations used today (present in effective endpoint).

Changes

No recorded changes to this operation across all 1 revision of this API.