Artifacts

Get an artifact

Returns an artifact you own, one shared with you, or a public one, with its current version's content.

get/api/v1/artifacts/{id}

Request

  • Base URL: https://your-deployment.example.com
  • URL: https://your-deployment.example.com/api/v1/artifacts/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Path parameters

idstring required

Response

The artifact and its current content.

idstring required
type'mermaid' | 'recharts' | 'chess' | 'python' | 'react' | 'html' | 'svg' | 'code' | 'quest' | 'file' | 'questmaster' | 'lattice' | 'blog-draft' required
titlestring required
descriptionstring nullable required
versioninteger required

The current version. Starts at 1; each content change adds one.

version_tagstring nullable required
status'draft' | 'review' | 'published' | 'archived' required
tagsstring[] required
session_idstring nullable required
project_idstring nullable required
visibility'private' | 'project' | 'organization' | 'public' required
created_atstring required

ISO 8601 timestamp.

updated_atstring required

ISO 8601 timestamp.

contentstring nullable required

The current version's content. null in a list (fetch the artifact by id for it), and in an update response to a caller who may edit the artifact but not read it, unless that update sent content.

Example response

{
  "id": "<artifactId>",
  "type": "mermaid",
  "title": "Signup flow",
  "description": null,
  "version": 2,
  "version_tag": null,
  "status": "draft",
  "tags": [
    "onboarding"
  ],
  "session_id": "<sessionId>",
  "project_id": null,
  "visibility": "private",
  "created_at": "2026-10-01T12:00:00.000Z",
  "updated_at": "2026-10-02T09:30:00.000Z",
  "content": "graph TD; A[Sign up] --> B[Verify email]"
}

Changes

No recorded changes to this operation across all 1 revision of this API.