> ## Documentation Index
> Fetch the complete documentation index at: https://usefoil.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent tokens API

> Verify and revoke Gate-issued agent tokens with your secret key, checking token validity, status, and expiry from your own API middleware.

Agent tokens (`agt_` prefix) are Gate-owned credentials issued on every successful signup. Use these endpoints to verify tokens in your API middleware and revoke them when needed.

## Endpoints

* `POST /v1/gate/agent-tokens/verify` — Verify an agent token
* `POST /v1/gate/agent-tokens/revoke` — Revoke an agent token

Both endpoints require:

* `Authorization: Bearer sk_*`
* Gate-specific scopes:
  * `gate:agent_tokens:verify`
  * `gate:agent_tokens:revoke`

See the [agent tokens guide](/gate/agent-tokens) for integration examples in all languages.

## Verify response

```json theme={"dark"}
{
  "data": {
    "valid": true,
    "gate_account_id": "gacct_...",
    "status": "active",
    "created_at": "2026-04-01T...",
    "expires_at": "2026-06-30T..."
  }
}
```

Returns `Cache-Control: no-store`.