Skip to main content
This reference gives the facts of agent registration. It follows the auth.md protocol. For the steps, see Register an agent. For the reasons behind the design, see How agents get access.

Check a fact about agent registration.

Discovery

The Authorization Server metadata has an agent_auth block with the endpoints, the methods, and identity_assertion.trusted_issuers.

Endpoints

Registration methods

All three methods are on.

ID-JAG rules

A new verified email gets a new account. A known (iss, sub) pair gets the account that it is linked to.

Tokens and limits

A claim gives new tokens and makes the tokens from before the claim stop working.

Revocation

The security event must have the event https://schemas.workos.com/events/agent/auth/identity/assertion/revoked with a subject { "format": "iss_sub", "iss", "sub" }. A provider can revoke only its own subjects.

Errors