Artifacts

Durable outputs jobs can pass to each other. Artifacts are created from completed jobs; the physical store is behind a stable storage_uri.

POST /v1/artifacts

Promote a completed job output into a durable art_ object. Returns 201.

curl -s -X POST https://api.skilleo.org/v1/artifacts \
  -H "Authorization: Bearer $SKILLEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id":"job_...","metadata":{"prompt":"a red cube"}}'

Code	When
NOT_FOUND	Unknown or unowned job
OUTPUT_NOT_READY	Job still running
OUTPUT_UNAVAILABLE	Job failed
OUTPUT_MISSING	Job output file missing
ARTIFACT_EXISTS	Artifact already created for this job

Response data

Field	Description
type	Logical type (image today)
mime_type	Content type
size_bytes	Stored object size
created_by_job	Source job id
storage_uri	Backend-agnostic URI (skilleo://v1/artifacts/art_...)
metadata	Caller-supplied JSON
download	Relative URL for bytes

No filesystem paths are returned.

GET /v1/artifacts

List non-deleted artifacts for the account.

curl -s https://api.skilleo.org/v1/artifacts \
  -H "Authorization: Bearer $SKILLEO_API_KEY"

GET /v1/artifacts/{id}

Fetch one artifact envelope.

curl -s https://api.skilleo.org/v1/artifacts/art_abc123 \
  -H "Authorization: Bearer $SKILLEO_API_KEY"

GET /v1/artifacts/{id}/content

Download artifact bytes. Same ownership as metadata.

curl -s -o cube.png https://api.skilleo.org/v1/artifacts/art_abc123/content \
  -H "Authorization: Bearer $SKILLEO_API_KEY"

DELETE /v1/artifacts/{id}

Delete stored content and mark the artifact deleted.

curl -s -X DELETE https://api.skilleo.org/v1/artifacts/art_abc123 \
  -H "Authorization: Bearer $SKILLEO_API_KEY"

Example

job = client.jobs.create(type="image", input={"prompt": "cube"})
client.jobs.wait(job["id"])

art = client.artifacts.create(job_id=job["id"], metadata={"prompt": "cube"})
client.artifacts.save(art["id"], "cube.png")

Job output remains available at GET /v1/jobs/{id}/output. Artifacts are the durable exchange primitive for workflows.