API Referenceruntimes

List runtimes

View as Markdown

List runtimes using compact runtime summaries. Omit spaceId to list runtimes across all spaces visible to the caller; pass spaceId to narrow to one space.

Authentication

AuthorizationBearer

Use Bearer <api-key>.

Headers

BCTRL-Subaccount-IdstringOptional
Optional effective subaccount context for organization API keys. Subaccount API keys are already scoped and cannot use this header to act as another subaccount.

Query parameters

spaceIdstringOptional

Filter by a prefixed space ID, or pass default to use the caller default space.

qstringOptional1-120 characters

Case-insensitive search across runtime name and id.

statuslist of enumsOptional
Filter by one or more runtime statuses. Repeat the query parameter for multiple values.
Allowed values:
includeenumOptional
Allowed values:
cursorstringOptional
limitintegerOptional<=200Defaults to 50

Response

OK
datalist of objects
nextCursorstring or null

Errors

401
Unauthorized Error
403
Forbidden Error