Artifact
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
| Method | Path | Description |
|---|---|---|
POST | /v1/artifacts | Create an artifact |
GET | /v1/artifacts | List artifacts |
GET | /v1/artifacts/:id | Get artifact metadata |
GET | /v1/artifacts/:id/content | Get raw content |
POST | /v1/artifacts/:id/links | Create a signed link |
POST | /v1/artifacts/:id/share | Share 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}'