---
title: "One artifact with every revision [read]"
method: GET
path: "/artifacts/{id}"
tags: ["artifacts"]
---

# One artifact with every revision \[read\]

`GET /artifacts/{id}`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/artifacts/{id}`
- Auth: HTTP bearer

Task DTOs remain unchanged. Private execution notes expose origin=execution, task_id=null, run_id, can_edit=false and independent can_discuss/can_manage controls. Read only currently authorized surviving files and history; no public URL grants execution-note access.

## Path parameters

- `id` string, required

## Query parameters

- `shared_token` string
- `universe` string

## Response `200`

OK

- object
  - `artifact` union, required: Task resources retain their original complete wire shape. Execution resources declare origin=execution, task_id=null and run_id, are private and generated-body read-only, and separate can_discuss from can_edit. Adopted private owner resources explicitly declare consumer_adopted/null task_id. Existing ASP reads return a narrow resource-only publisher shape without owner/policy/public/share/discussion data; can_edit=false describes generic user editing, not the existing operation-bound publisher protocol.
    - object
      - `id` string, required
      - `task_id` string, required: The task it belongs to (sess_…)
      - `name` string, required: Unique within the task; publishing under the same name adds a version
      - `kind` 'design_system' | 'null', nullable, required: design_system when the current revision holds project/design-system.json; null otherwise
      - `version` integer, required: The current revision
      - `entry` string, required: The file opened first
      - `files` object[], required
        - `path` string, required
        - `sha256` string, required
        - `size_bytes` integer, required
      - `share_url` string, nullable, required: The public link, or null while not shared
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `revisions` ArtifactRevision[], required
        - `version` integer, required
        - `entry` string, required
        - `files` object[], required
          - `path` string, required
          - `sha256` string, required
          - `size_bytes` integer, required
        - `published_by_session` string, nullable, required: The session that published it; null when a person or developer did
        - `created_at` string, date-time, required
    - AdoptedArtifact
      - `id` string, required
      - `origin` 'consumer_adopted', required
      - `task_id` unknown, required
      - `owner_user_id` string, required
      - `name` string, required
      - `kind` unknown, required
      - `version` integer, required
      - `entry` string, required
      - `files` object[], required
        - `path` string, required
        - `sha256` string, required
        - `size_bytes` integer, required
      - `share_url` unknown, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `source` object, required
        - `namespace` 'agent-use', required
        - `id` string, required
        - `binding_epoch` integer, required
      - `policy_version` integer, required
      - `access` 'view' | 'edit' | 'owner', required
      - `can_edit` boolean, required
      - `can_manage` boolean, required
      - `is_public` boolean, required: Current direct/alias public-enabled state for private metadata projection; not anonymous discovery authority
      - `selected_alias` object, nullable, required
        - `id` string, required
        - `revision` integer, required
        - `workspace` object, nullable, required
          - `slug` string
          - `created_at` string, date-time
      - `mutation_request_id` string, uuid: Adopted DS save response only: stable exact mutation recovery identity; ordinary metadata reads omit it
      - `revisions` object[], required
        - `version` integer, required
        - `entry` string, required
        - `files` object[], required
          - `path` string, required
          - `sha256` string, required
          - `size_bytes` integer, required
        - `published_by_session` string, nullable, required: The session that published it; null when a person or developer did
        - `created_at` string, date-time, required
        - `canonical_revision_id` string, required
        - `request_id` string, required
        - `raw_sha256` string, required
        - `raw_size_bytes` integer, required
        - `media_type` string, required
        - `site` boolean, required
        - `restored_from` integer, nullable, required
    - PublisherArtifact
      - `id` string, required
      - `origin` 'consumer_adopted', required
      - `name` string, required
      - `version` integer, required
      - `source` object, required
        - `namespace` 'agent-use', required
        - `id` string, required
        - `binding_epoch` integer, required
      - `access` 'publisher', required
      - `can_edit` unknown, required
      - `can_manage` unknown, required
      - `revisions` object[], required
        - `version` integer, required
        - `canonical_revision_id` string, required
        - `request_id` string, required
        - `raw_sha256` string, required
        - `raw_size_bytes` integer, required
        - `media_type` string, required
        - `site` boolean, required
        - `restored_from` integer, nullable, required
        - `created_at` string, date-time, required
    - ExecutionArtifact: Private service-generated meeting note/facts. task_id is null; run_id identifies the owning execution, and exact workspace grants come from current policy rather than an invented task. Generated content is read-only even when can_discuss permits comments. Current/history/file/export, discussion, policy and deletion reuse their existing artifact endpoints; no public sharing or generic body mutation is available.
      - `id` string, required
      - `origin` 'execution', required
      - `task_id` unknown, required
      - `run_id` string, required
      - `owner_user_id` string, required
      - `name` string, required
      - `version` integer, required
      - `updated_at` string, date-time, required
      - `source` object, required
        - `namespace` 'recall', required
        - `id` string, required
      - `policy_version` integer, required
      - `access` 'view' | 'edit' | 'owner', required
      - `can_edit` unknown, required
      - `can_manage` boolean, required
      - `kind` unknown, required
      - `entry` string, required
      - `files` object[], required
        - `path` string, required
        - `sha256` string, required
        - `size_bytes` integer, required
      - `share_url` unknown, required
      - `created_at` string, date-time, required
      - `can_discuss` boolean, required
      - `selected_alias` unknown, required
      - `is_public` unknown, required
      - `revisions` object[], required
        - `version` integer, required
        - `entry` string, required
        - `files` object[], required
          - `path` string, required
          - `sha256` string, required
          - `size_bytes` integer, required
        - `published_by_session` unknown, required
        - `created_at` string, date-time, required
        - `canonical_revision_id` string, required

## Other responses

- `default`: Error — { error: { code, message } }

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 breaking, 4 info
  - added `#/components/schemas/AdoptedArtifact, #/components/schemas/PublisherArtifact, #/components/schemas/ExecutionArtifact, subschema #1` to the `artifact` response property `oneOf` list for the response status `200`
  - added the new optional `query` request parameter `shared_token`
  - added the new optional `query` request parameter `universe`
  - added the optional property `error/request_id` to the response with the `default` status
  - …1 more

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/artifacts/:id/get.md)

---

[API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [All operations](https://skmtc.dev/agentsky/apis/agentsky-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/agentsky/apis/agentsky-developer-api/revisions/8280a065ef6a?raw)