Agent tokens API - Foil

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 for integration examples in all languages.

Verify response

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

Returns Cache-Control: no-store.