Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.goantiai.com/llms.txt

Use this file to discover all available pages before exploring further.

Tokens are short-lived credentials your agent uses to authenticate to downstream services. The SDK handles this automatically.

How it works

Agent → Anti AI (client_id + client_secret + scope)
              ↓ policy check
         Issue JWT (signed, expires in 10 min)

Agent ← access_token + expires_in

Request a token

from oculus_sdk import OculusClient

client = OculusClient(
    client_id="YOUR_CLIENT_ID",
    client_secret="YOUR_CLIENT_SECRET",
)

token = client.get_token(scope="db:read")

Token lifetimes

SituationLifetime
Standard10 minutes
High-risk scopes (*:write, *:delete, *:admin)15 minutes max
Custom per-agent TTL5 minutes to 24 hours
Tokens with write or admin scopes are capped at 15 minutes regardless of your custom TTL. This cannot be disabled.
The SDK caches tokens, renews them before expiry, and detects revocations via background TRL polling every 15 seconds. You never manage token lifetimes manually.