Skip to main content
GET
List a person's communication profile revisions
Lists the person’s communication profile revisions, newest first, without their editor. limit is 1–50 (default 25). Continue with meta.nextCursor while meta.hasMore is true; an unreadable cursor returns 400. Requires workforce:manage at the platform scope; a key or app whose grant covers only some org units receives 403. A person with any seat in a customer organization or an org unit under one returns 404, exactly as an unknown person, and so does an ID merged into such a person; a merged-away ID otherwise resolves to the person it was merged into.

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

personId
string
required
Minimum string length: 1

Query Parameters

limit
integer
default:25
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.