Skip to main content
GET
/
api
/
v1
/
guardrail-policies
/
{id}
/
bindings
List Keys Bound to a Policy
curl --request GET \
  --url https://api.example.com/api/v1/guardrail-policies/{id}/bindings

Documentation Index

Fetch the complete documentation index at: https://docs.hitheo.ai/llms.txt

Use this file to discover all available pages before exploring further.

Returns every active (non-revoked) API key currently bound to the given policy. Use this to confirm a policy is enforcing on the keys you expect before relying on it in production.

​
Authentication

Requires a Bearer token with the billing API key scope. Visibility: author or any member of the owning org.

​
Request Examples

curl https://www.hitheo.ai/api/v1/guardrail-policies/{id}/bindings \
  -H "Authorization: Bearer $THEO_API_KEY"

​
Response

{
  "policy_id": "1f4f2c1a-22ce-4b07-9c0b-9c4f4b9b1d2e",
  "bindings": [
    {
      "key_id": "key_abc123",
      "key_name": "Production",
      "key_prefix": "theo_sk_abc12345",
      "key_org_id": null,
      "key_user_id": "user_xyz",
      "bound_at": "2026-01-15T18:24:11.000Z"
    }
  ],
  "count": 1
}