Artifacts

List artifacts

Lists the artifacts you own, newest first, excluding deleted ones. Artifacts shared with you are not listed, though GET /api/v1/artifacts/{id} resolves them by id. Items carry content: null; fetch an artifact by id for its content. Cursor-paginated (see the pagination convention): pass next_cursor back as cursor until it is null.

get/api/v1/artifacts

Request

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

Query parameters

limitinteger
cursorstring

Response

One page of artifacts, newest first.

next_cursorstring nullable required

Example response

{
  "data": [
    {
      "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": null
    }
  ],
  "next_cursor": null
}

Changes

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