The one failure shape, the same fields as the AI and Store failures so a gateway client reads every domain's error the same way.
API reference sections
Schema
ArtifactFailure
Type object
Shape
| Field | Type | Description |
|---|---|---|
| coderequired | string | A stable code from |
| messagerequired | string | Safe developer-facing detail. Never a title, a filename or a principal. |
| retryablerequired | boolean | |
| details | object |
{
"code": "string",
"message": "string",
"retryable": false,
"details": {}
}The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.
Used by
GET
The artifact families of a workspace/v1/artifacts/familiesPOST
Create an artifact family/v1/artifacts/familiesGET
A family with its versions/v1/artifacts/families/{family}POST
Retire a family/v1/artifacts/families/{family}/retirePOST
Register an immutable version of a family/v1/artifacts/families/{family}/versionsGET
One artifact version/v1/artifacts/versions/{version}PATCH
Refused: a version cannot be changed (also PUT and DELETE)/v1/artifacts/versions/{version}GET
A version's provenance/v1/artifacts/versions/{version}/provenanceGET
A version's bytes/v1/artifacts/versions/{version}/contentPOST
Record that a run consumed or produced a version/v1/artifacts/versions/{version}/runsPOST
Issue a run's authority and its first endpoint token/v1/artifacts/authoritiesGET
A run's authority record/v1/artifacts/authorities/{run}POST
A fresh attempt: advance the run's generation under a fresh token/v1/artifacts/authorities/{run}/generationPOST
Revoke a run's authority/v1/artifacts/authorities/{run}/revokeGET
Where the run worked, as this device resolved it/v1/artifacts/authorities/{run}/workspacePOST
The run was deleted: forget its authority/v1/artifacts/authorities/{run}/forgetGET
The versions a run has registered/v1/artifacts/runs/{run}/versionsGET
What a workspace's runs wrote and never registered/v1/artifacts/unregisteredPOST
Register a file the run left in its results folder (D19)/v1/artifacts/runs/{run}/register
Generated from contract version 1. Last updated .