List available composition acts
Returns the catalog of live composition acts you can pin via action_id on POST /v1/images. Each act carries the subject counts it supports (supported_character_counts) — pin it with a matching number of subjects, or with zero subjects to render a new person your prompt describes. Selecting an act is optional: omit action_id to let act detection run automatically, or send null to disable it for a request.
Authorizations
Your team API key (starts with al_live_).
Headers
Optional API version pin (YYYY-MM-DD). Defaults to your team's pinned version, or the system default 2026-07-16 for unauthenticated requests.
^\d{4}-\d{2}-\d{2}$"2026-07-16"
Response
List of composition acts
Composition-act identifier — pin via action_id on POST /v1/images.
"3f2b6c1e-8a4d-4e2b-9c7a-1d5e8f0a2b3c"
Display name.
"Over-the-shoulder"
Subject counts this act supports. Pin with a matching number of subjects; an unsupported count returns 400 action_not_available. Empty only transiently.
What the act does.
A signed preview image URL served by the API (GET /v1/actions/{id}/preview), short-lived (~1h) and re-minted every time you list the catalog. The bytes stream through the API — it is never a raw storage path or a link to the storage provider. Fetch it fresh rather than storing it. null when the act has no preview image.

