SaaS Management: List Enrollment Tokens and Get Token Values
Summary
You can now find and reuse a client's existing enrollment tokens through the Lifecycle Manager API. Before this release, you could only create tokens. Two new endpoints let you list a client's tokens and get the value of an active token. An agent deployment can now reuse the client's active token and create a new token only when the client has none.
To deploy an agent, send your API key in the x-api-key header. List the client's active tokens with filter[status]=eq:active, then get the token value by its id. Getting a token value requires the amm.enrollment-tokens:write scope, because the value is a live credential. Listing tokens requires the amm.enrollment-tokens:read scope.
The reference lists these endpoints under ScalePad Platform / Enrollment Tokens. The same endpoints also accept requests under /lifecycle-manager/v1/saas-management/clients/{client_id}/enrollment-tokens.
There are no breaking changes, and the version stays v1.
Changes
New endpoints
ScalePad Platform / Enrollment Tokens
-
GET
/app/v1/clients/{client_id}/enrollment-tokens- N/A → Available
- Type: addition
- Notes: Returns the client's enrollment tokens with their status, usage counts, and expiry. Token values are not included. Filter by status (active, expired, exhausted, or revoked), sort by creation date, expiry, or status, and page through results with a cursor.
-
GET
/app/v1/clients/{client_id}/enrollment-tokens/{token_id}/value- N/A → Available
- Type: addition
- Notes: Returns the value of an active enrollment token. The agent installer uses this value to enroll a device. A token that is expired, exhausted, or revoked returns
404.
Changed
- POST
/app/v1/clients/{client_id}/enrollment-tokens- Undocumented → Documented
- Type: improvement
- Notes: The response now documents
created_at, the time the token was created. The reference now also documents the403response that is returned when your API key does not have theamm.enrollment-tokens:writescope, and theRetry-Afterheader on429responses.client_idis the client's ScalePad Core identifier. The endpoint's behavior does not change.
Dates
- Effective: [2026-11-06]
