Execution Intents

Update binding

patch/v1/agents/{agent_id}/bindings/{binding_id}

Request

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

Path parameters

agent_idstring uuid required
binding_idstring uuid required

Request body

configobject
is_activeboolean
credentialobject

Legacy: inline credential value.

approval_idstring uuid

Recorded on the guardrail revision row for reference. It does not gate or bypass anything: a binding guardrail widening always queues when the org requires approval, and the server applies it when the approval is approved via POST /v1/approvals/{approval_id}/decide, with nothing to resubmit.

Response

Binding updated

idstring uuid required
agent_idstring uuid required
binding_type'http' | 'graphql' | 'postgres' | 'mysql' | 'redis' | 'grpc' | 'smtp' | 'cloud_sdk' | 's3' | 'custom' required
namestring required
configobject
is_activeboolean required
credential_setboolean

Whether a credential is stored for this binding. The value itself is never returned.

credential_source_type'inline' | 'vault_ref' nullable

How the credential is sourced — inline (HSM-encrypted copy) or vault_ref (live pointer).

credential_vault_idstring uuid nullable

For vault_ref credentials — the vault containing the referenced secret.

credential_pathstring nullable

For vault_ref credentials — the secret path in the referenced vault.

created_atstring date-time required
updated_atstring date-time required

Changes

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