Skip to navigation
Runtype APIAgent Aliases

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
liveDefaultboolean

Whether an execution that names no version selector already resolves this agent through its live alias. False means a save still changes what runs, so moving production needs a publish; true means live is authoritative and moving production is an alias activation.

nextCursorstring or null

Errors

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