# GTA 6 Zoom agent authentication

The public catalog and guide articles allow anonymous requests without a credential. Use the sandbox to obtain and exercise a short-lived, read-only OAuth credential.

## Discover

Open https://www.gta6zoom.com/agent/auth/ and follow the resource_metadata URL in the sandbox’s WWW-Authenticate header. You can also start at https://www.gta6zoom.com/.well-known/oauth-protected-resource. Read authorization_servers, then fetch /.well-known/oauth-authorization-server at the listed issuer for agent_auth and token_endpoint.

## Pick a method

Read agent_auth.identity_types_supported. The sandbox accepts anonymous registration for guides:read. Account-linked identity_assertion (ID-JAG, urn:ietf:params:oauth:token-type:id-jag) and service_auth are unavailable.

## Register

POST {"type":"anonymous"} as application/json to identity_endpoint at https://www.gta6zoom.com/api/v1/agent/identity.json. Keep the returned identity_assertion in memory until exchange. The assertion expires in five minutes.

## Claim

Skip the claim step. Anonymous registration grants guides:read immediately and the sandbox does not link user accounts.

## Exchange

POST application/x-www-form-urlencoded to https://www.gta6zoom.com/api/v1/agent/token.json with grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer and assertion set to the URL-encoded identity_assertion. Set resource to https://www.gta6zoom.com/api/v1/agent/sandbox.json if your client sends a resource indicator.

## Use the access_token

GET https://www.gta6zoom.com/api/v1/agent/sandbox.json?lang=es with Authorization: Bearer <access_token>. The response contains the guides catalog. Tokens expire after 600 seconds.

## Errors

For invalid_grant, register again and exchange a fresh assertion. A sandbox 401 carries WWW-Authenticate and a JSON code. For HTTP 503, you can use the public catalog while the sandbox is unavailable.

## Revocation

Discard the token when finished. Sandbox tokens expire automatically and grant only guides:read. There is no persistent delegated consent or per-token revocation endpoint.

Protocol reference: [WorkOS auth.md](https://github.com/workos/auth.md).
