API keysKey binding

Key binding

Bind a key to a registered agent and restrict it to specific roles.

Bind a key to an agent

Bind a key to a specific registered agent and/or restrict it to a set of roles. Both fields are optional and independent — you can set one or both.

Binding fields

FieldTypeEffect
bound_agent_idstringThe key will only accept evaluate calls that present this exact agent_id. Requests with a different or missing agent_id are denied with policy_name="key_agent_binding".
permitted_roleslistThe key will only accept evaluate calls that claim a role in this list. Empty list or omitted = no role restriction.