agent-auth

Exchange Atb Cert

Exchange an ATB ZKP certificate for an agent session token.

Requires normal API key auth (X-Tenant-Id + Authorization: Bearer <api_key>) for this request only. The returned token is used for all subsequent calls within the session.

post/auth/token

Request

  • Base URL: https://api.algovoi.co.uk (the document declares no server; this is the origin it was published from)
  • URL: https://api.algovoi.co.uk/auth/token
  • Auth: none declared

Query parameters

tenant_idstring uuid nullable

Headers

x-tenant-idstring nullable
authorizationstring nullable

Request body

atb_zk_credentialstring nullable

Base64url ATB ZKP Phase 2 cert. Provide this OR federation_token.

federation_tokenstring nullable

Pre-composed federation token from algovoi-federation-validator. Provide this OR atb_zk_credential. Requires FEDERATION_VALIDATOR_ENABLED=true.

spend_cap_usdnumber nullable

Per-session spend cap in USD. Defaults to 100.0. Set to 0 to allow dry-run session (no payments).

ttl_secsinteger nullable

Session lifetime in seconds. Defaults to 3600. Max 86400 (24 h).

Response

Successful Response

tokenstring required
token_typestring
expires_ininteger required
spend_cap_usdnumber required
jtistring required

Changes

No recorded changes to this operation across all 1 revision of this API.