Get a composition act by ID
Resolves an id from GET /v1/actions — a cheap liveness / support check for a persisted action_id (an act’s supported_character_counts changes as its stills are approved). Returns 404 for any id that is not a live act visible to your team.
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"
Path Parameters
Composition-act id from GET /v1/actions.
"3f2b6c1e-8a4d-4e2b-9c7a-1d5e8f0a2b3c"
Response
Composition act details
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.

