Skip to main content
GET
List a customer's scope links
Returns the links from one customer to the scopes that work with it, oldest first, as {scopes, count}. Each CustomerScope carries id, customerId, scopeType (org_unit, external_app, project or factory), scopeId, createdAt and isPrimary when set. A link’s own data and creator are never returned. At most 100 links are read; meta.partial is true when the customer has more. A link to the customer’s own organization unit, or to a unit under it, is omitted, so count can be lower than the number of links read. customerId must appear exactly once; a missing, repeated, malformed or unknown customerId is 404 resource_missing “Customer not found”. The credential needs customers:read granted at the deployment root.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Path Parameters

customerId
string
required

The customer id

Minimum string length: 1

Query Parameters

limit
integer
default:100

Items per page, 1 to 100 (default 100); a larger value is a 400 too_big. A page may hold fewer items than limit while meta.hasMore is true; continue with meta.nextCursor.

Required range: 1 <= x <= 100
cursor
string

The previous page's meta.nextCursor; any other value is 400.

Minimum string length: 1

Response

The customer's scope links

data
object[]
required
meta
object
required

A list page's continuation. While hasMore is true, nextCursor is a string: pass it as cursor for the next page. hasMore: false ends the list; with truncated: true, more exist past what this list reads, and no cursor reaches them.