Skip to main content
POST
/
v1
/
gate
/
agent-tokens
/
verify
Verify a Gate agent token
curl --request POST \
  --url https://api.usefoil.com/v1/gate/agent-tokens/verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_token": "agt_0123456789abcdefghjkmnpqrstuvwxyzABCDEF"
}
'
{
  "data": {
    "valid": true,
    "gate_account_id": "gacct_0123456789abcdefghjkmnpqrs",
    "status": "active",
    "created_at": "2026-03-24T20:00:00.000Z",
    "expires_at": "2026-03-24T20:00:05.000Z"
  },
  "meta": {
    "request_id": "req_cf147349a4134208aebb8c70e25fb7e1"
  }
}

Authorizations

​
Authorization
string
header
required

Send Authorization: Bearer . Gate business endpoints require sk_* secret keys. Gate workflow endpoints use gate-native bearer tokens such as gtpoll_* or agt_* where documented.

Body

application/json
​
agent_token
string
required
Example:

"agt_0123456789abcdefghjkmnpqrstuvwxyzABCDEF"

Response

Agent token verification response.

​
data
object
required
Example:
{
  "valid": true,
  "gate_account_id": "gacct_0123456789abcdefghjkmnpqrs",
  "status": "active",
  "created_at": "2026-03-24T20:00:00.000Z",
  "expires_at": "2026-03-24T20:00:05.000Z"
}
​
meta
object
required
Example:
{
  "request_id": "req_cf147349a4134208aebb8c70e25fb7e1"
}