Skip to content

Connector artifact

GET
/connector/v1/assignments/{assignment_id}/artifacts/{artifact_id}

Only artifacts produced by this exact assignment or pinned as its accepted inputs are accessible. The assignment must belong to the authenticated connector. Existing delegation survives session release and later installation/publication revocation. Only schema-declared file inputs create dependency pins; arbitrary input JSON confers no access.

assignment_id
required
string format: uuid
artifact_id
required
string format: uuid

Metadata for this assignment’s output or pinned input artifact.

Media typeapplication/json
object
artifact_id
required
string format: uuid
availability
required

Metadata availability is separate from a producing run’s historical outcome. Ready means an exact version was verified and published. HTTP downloads and file-input authorization remain separate operations.

string
Allowed values: pending ready unavailable expired
availability_updated_at
required
string
created_at
required

UTC with PostgreSQL microsecond precision.

string
created_by_user_id
required
string format: uuid
description
required

Description supplied by trusted application code; ownership is never supplied. Scientific metadata uses the same bounded, exact JSON storage profile as inputs.

object
logical_name
required
string
media_type
required

A bare type/subtype, without parameters or wildcards.

string
scientific_metadata
required

An object of scientific annotations, not executable schema/file instructions.

storage_destination_id
required

An opaque service-selected destination identity, not a storage URL.

string
provenance
required
One of:
object
kind
required
string
Allowed values: user_upload
content
One of:
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.

Query parameters are not accepted.

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.

Active connector credential required.

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.

Invalid identity or artifact outside this exact owned assignment.

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.

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.

Artifact records unavailable.

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.