Added

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 the 403 response that is returned when your API key does not have the amm.enrollment-tokens:write scope, and the Retry-After header on 429 responses. client_id is the client's ScalePad Core identifier. The endpoint's behavior does not change.

Dates

  • Effective: [2026-11-06]