← All primitives

Artifact

implemented P0 /v1/artifacts

Why it matters: Universal output primitive — every agent needs to produce, version, and share artifacts.

Versioned, shareable objects: text, JSON, HTML, files, and blobs.

API endpoints

MethodPathDescription
POST/v1/artifactsCreate an artifact
GET/v1/artifactsList artifacts
GET/v1/artifacts/:idGet artifact metadata
GET/v1/artifacts/:id/contentGet raw content
POST/v1/artifacts/:id/linksCreate a signed link
POST/v1/artifacts/:id/shareShare by email

Examples

Create a text artifact

curl -X POST https://cloudharness.ai/v1/artifacts \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"note","content":"hello"}'

Create a signed link

curl -X POST https://cloudharness.ai/v1/artifacts/ARTIFACT_ID/links \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"ttlSeconds":3600}'