Lists the customers holding relations on one app, one cursor page at a time.
Changed onapp is required: each app is a separate object in the graph, so there is no combined listing. Returns every relation unless relation narrows it. Follow nextCursor to page.
Request
- Base URLhttps://api.rapidata.ai
- URLhttps://api.rapidata.ai/authorization/relations/external-app
- AuthOpenID Connect (https://auth.rapidata.ai/.well-known/openid-configuration, scopes: openid, profile, email, offline_access, api)
Query parameters
The third-party applications that federate on our OIDC `groups` claim and can therefore
be administered through a grant here. Each maps to an `external_app` object in the
authorization graph.
A closed enum rather than a free-form id on purpose: an arbitrary string would let a typo
write a grant against an object nothing consumes, which looks like access was granted but silently is not. Adding an app is a value here plus a tuple — no model change.This is the app itself; the relation vocabulary defined on these objects is AuthorizationRelations.ExternalApp. The Id suffix here keeps the two distinguishable: a file with using static AuthorizationRelations imports that nested enum, and identical short names would make every bare mention ambiguous.
The app whose members to list.
Relations on an external_app object — one object per third-party app that federates on the OIDC groups claim. The apps themselves are ExternalAppId. The ladder is hierarchical: admin folds into user, and user into viewer. Grants are direct and, like Bidder, are never folded in from platform staff — holding platform admin must not confer administration of a separate system.
Optional relation to filter by.
The opaque cursor from the previous page; omit for the first page.
The number of items per page.
Response
OK
Changes
- warning
added the new
Headscaleenum value to the//response property for the response status - warning
added the new
Userenum value to the//response property for the response status - info
added the new enum value
Headscaleto thequeryrequest parameterapp - info
added the new enum value
Userto thequeryrequest parameterrelation
- warning
- info
the security scope
apiwas added to the endpoint's security schemeOpenIdConnect
- info