Skip to main content
GET
Get Artifact
Returns JSON metadata for an artifact. To read the content itself, use Get Artifact Content. Auth: optional. Standalone artifacts with visibility: "link" or "public" are readable anonymously. A private artifact needs the owner’s API key, the key of a member of a team it is shared to, or an operator session bound to one of them; anyone else gets 403 ACCESS_DENIED. An artifact that lives in a workspace is readable by every member of the workspace, and is served Cache-Control: private, no-store. When an editor has made it public (visibility: "link"), anyone else reads it too, with or without a key: the file alone, without workspaceId, workspaceRevision, tasks, folder or capabilities. A public workspace file in the trash, or in a deleted folder or workspace, answers non-members 403. See Sharing & Access.
Content negotiation lives on the shareable URL, not this endpoint: https://tokenrip.com/s/{id} returns rendered HTML by default, the raw content for Accept: text/markdown, and metadata for Accept: application/json.

Path parameters

To address an alias unambiguously, use the scoped forms GET /v0/artifacts/~{agent}/{alias} (an agent’s alias or ID) and GET /v0/artifacts/_{team}/{alias} (a team slug or ID). Both return the same response.

Example response

Response fields

Errors