Skip to content

List committed output collections in declared-name order.

GET
/api/v1/runs/{id}/collections

List committed output collections in declared-name order.

Credential scopes: artifacts:read

Resource authority: Creator of a user-upload collection for mutations; producing output collections are published only by their assignment connector/session. Reads additionally permit current administrators of an accepting or producing run.

Retry: Repeat GET using the same resource identity; each request rechecks current credential and resource authority.

Guards: No mutation or execution authority is granted.

Retain: Run identity; opaque cursor where returned.

Specific failures: 400 invalid_query; 403 insufficient_scope; 404 not_found: missing or unauthorized collection/run; 503 collection_uncertain

Next action: Inspect current state; follow exact referenced artifact identities. Worked workflow

id
required
string format: uuid

At most 64 committed output collection summaries.

Media typeapplication/json
object
items
required
Array<object>
<= 64 items
object
collection
required

Compact listing; full scientific metadata remains on the collection itself.

object
available
required
boolean
collection_id
required
string format: uuid
manifest_digest
string | null
member_count
required
integer format: int32
state
required
string
total_bytes
required
integer format: int64
output_name
required
string
next_cursor
required
null

Examples

Exampleno-run-output-collections

no-run-output-collections

The exact digest input is the two UTF-8 bytes []. Empty collections need freeze and completion but no member page or upload.

{
"items": [],
"next_cursor": null
}
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Active credential required.

Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

The credential does not permit this operation (insufficient_scope).

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Unknown or unauthorized run.

Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

413: the request body exceeds the configured size limit.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

An HTTP request failed; inspect the stable error code and request ID.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Documentation 205dcb3116ea · public sources 8c70356d340f · built .Download documentation identity.