agrirouterDocs

Authorization revoked

SSE event emitted when your application's authorization for a tenant is revoked

event: AUTHORIZATION_REVOKED

Emitted when your application's authorization for a tenant is revoked, either by the user in the agrirouter UI or by your application itself calling DELETE /authorizations. By the time you receive this event, your access to the target tenant for the given scope is already gone. Treat it as a cleanup signal: drop locally cached state for the tenant and stop calling APIs scoped to it.

When the user revokes in the agrirouter UI, all endpoints that were previously accessible via this authorization are removed as part of the revocation, and you receive a separate ENDPOINT_DELETED event for each one. When your application revokes through the API, it must have deleted its endpoints beforehand.

Authorizations are uniquely identified by the triple (tenant_id, application_id, scope); only the authorization matching the scope below was revoked. At present the only scope in use is endpoints:manage, but if additional scopes are introduced later, other scopes for the same tenant remain in effect.

Data fields

FieldTypeRequiredDescription
event_typestring (AUTHORIZATION_REVOKED)yesDiscriminator; matches the event: line.
tenant_idUUIDyesThe tenant whose authorization was revoked.
scopestringyesThe OAuth scope of the authorization that was revoked. Today the only value in use is endpoints:manage.

Sample frame

event: AUTHORIZATION_REVOKED
data: {"event_type":"AUTHORIZATION_REVOKED","tenant_id":"12345678-abcd-ef01-2345-6789abcdef01","scope":"endpoints:manage"}

See also

On this page