List release aliases for an agent

List the named pointers that select which immutable version of this agent runs. live sorts first, then the preview aliases by name. Archived aliases are omitted unless includeArchived=true. Omitting limit returns every pointer; supplying it pages through the same order with cursor.

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

idstringRequired

Query parameters

includeArchivedstringOptional

Pass true to include archived aliases, which never resolve for execution.

limitstringOptional
Maximum aliases to return. Omit for the full set.
cursorstringOptional

The nextCursor from a previous page of this same order.

Response

Release aliases
datalist of objects
nextCursorstring or null

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error