Skip to main content

​
Artifacts API

Create, retrieve, export, reconcile, and download persisted artifact bundles.

​
Use This API To

  • Persist derived reports or workflow outputs for later retrieval.
  • Download artifact payloads or export them in the format your workflow needs.
  • Reconcile artifact metadata when storage upload state must be verified.

​
Before You Call

1

Create artifacts from server-side workflows that can preserve provenance

Create artifacts from server-side workflows that can preserve provenance.
2

Use manifests when you need metadata before downloading the full payload

Use manifests when you need metadata before downloading the full payload.
3

Log artifact IDs with the originating request and organization

Log artifact IDs with the originating request and organization.

​
Endpoints

GET /v1/artifacts

List canonical artifacts for the current organization

POST /v1/artifacts

Create and persist a derived artifact bundle

GET /v1/artifacts/{artifact_id}

Fetch persisted artifact metadata

GET /v1/artifacts/{artifact_id}/download

Download or redirect to the persisted artifact payload

GET /v1/artifacts/{artifact_id}/export

Export an artifact as structured JSON or a markdown-oriented download envelope

GET /v1/artifacts/{artifact_id}/manifest

Fetch the structured manifest for a persisted artifact

POST /v1/artifacts/{artifact_id}/reconcile

Reconcile artifact metadata with object storage and upload if needed

GET /v1/artifacts/summary

Return artifact lifecycle counts by kind, status, and storage mode