Skip to main content
GET
List a pod's Customer assignment history
Pages through every Customer assignment the pod has had, latest effective end first. limit defaults to 20, at most 50 (a larger value is 400 too_big); continue with meta.nextCursor while meta.hasMore is true. An unreadable cursor returns 400. A pod managed by or under a customer organization returns 404, exactly as a missing pod. It requires workforce:read at the platform scope; no customers:read is needed.

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

podId
string
required
Minimum string length: 1

Query Parameters

limit
integer
default:20
Required range: 1 <= x <= 50
cursor
string
Minimum string length: 1

Response

Success

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.