Skip to content

Artifacts

List Artifacts

List artifacts in the organization, newest first.

Mirrors the detail endpoint’s scoping: org membership is sufficient, since org_id is a direct column on every artifact — this surfaces exactly what GET /{artifact_id} already lets a member read one at a time, it does not widen access.

Parameters

NameInTypeRequiredDescription
limitqueryintegernoMax rows to return (1-100). Omit to return every row.
offsetqueryintegernoRows to skip — pass the previous response’s next_offset.
org_idpathstring (uuid)yes

Responses

StatusDescriptionBody
200Successful ResponsePage_ArtifactDetailResponse_
422Validation ErrorHTTPValidationError

GET /api/orgs/{org_id}/artifacts/{artifact_id}

Section titled “GET /api/orgs/{org_id}/artifacts/{artifact_id}”

Get Artifact

Get a single artifact by ID.

Requires membership in the organization.

Parameters

NameInTypeRequiredDescription
artifact_idpathstring (uuid)yes
org_idpathstring (uuid)yes

Responses

StatusDescriptionBody
200Successful ResponseArtifactDetailResponse
422Validation ErrorHTTPValidationError

GET /api/orgs/{org_id}/artifacts/{artifact_id}/download

Section titled “GET /api/orgs/{org_id}/artifacts/{artifact_id}/download”

Download Artifact

Download the raw bytes of a FILE-type artifact.

Only valid for artifacts with artifact_type == “file”. For all other types (code, markdown, text, json) the content is already inline in the GET /{artifact_id} response.

Returns the file bytes with appropriate Content-Type and Content-Disposition headers so browsers trigger a native download.

Parameters

NameInTypeRequiredDescription
artifact_idpathstring (uuid)yes
org_idpathstring (uuid)yes

Responses

StatusDescriptionBody
200Successful Responseobject
422Validation ErrorHTTPValidationError