# Agent Registration #### Example AgentRegistration ## Get an agent registration Retrieve the details of an agent registration by ID. The registration is scoped to the environment of the API key used to authenticate the request. #### Request #### Response ## Validate an agent credential Validate an agent credential — an API key or access token — against the environment of the API key used to authenticate the request. This is a read-only check: it never consumes or mutates the credential. #### Request #### Response ### agent_registration | Field | Type | Required | Description | | --- | --- | --- | --- | | `id` | string | Yes | Unique identifier of the agent registration. | | `agent_identity` | object | Yes | The agent identity associated with this registration. | | `organization_id` | string | Yes | Identifier of the organization the agent is registered to. | | `status` | "unverified" \| "verified" \| "expired" \| "revoked" | Yes | The current verification status of the registration. | | `kind` | "anonymous" \| "service_auth" \| "identity_assertion" | Yes | The kind of agent registration. | | `claim` | object | No | The claim associated with this registration, or `null` if the registration has no claim. | | `created_at` | string | Yes | The timestamp when the registration was created. | | `updated_at` | string | Yes | The timestamp when the registration was last updated. | ### GET /agents/registrations/{id} #### Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `id` | string | Yes | The unique ID of the agent registration. | #### Returns | Field | Type | Description | | --- | --- | --- | | `id` | string | Unique identifier of the agent registration. | | `agent_identity` | object | The agent identity associated with this registration. | | `organization_id` | string | Identifier of the organization the agent is registered to. | | `status` | "unverified" \| "verified" \| "expired" \| "revoked" | The current verification status of the registration. | | `kind` | "anonymous" \| "service_auth" \| "identity_assertion" | The kind of agent registration. | | `claim` | object | The claim associated with this registration, or `null` if the registration has no claim. | | `created_at` | string | The timestamp when the registration was created. | | `updated_at` | string | The timestamp when the registration was last updated. | ### /agents/credentials/validate | Field | Type | Required | Description | | --- | --- | --- | --- | | `type` | "api_key" \| "access_token" | Yes | The kind of credential being validated — an agent API key or an agent access token. | | `credential` | string | Yes | The credential value to validate: the API key value for `api_key`, or the access token (JWT) for `access_token`. | | `audience` | string | No | Only applies to `access_token` credentials. When provided, the access token's `aud` claim is verified against this value — tokens issued for a different resource are rejected. Not permitted for `api_key` credentials. |