---
title: "Read purpose-bound exact content request"
method: GET
path: "/artifacts/{id}/mutations/{requestId}"
tags: ["artifacts"]
---

# Read purpose-bound exact content request

`GET /artifacts/{id}/mutations/{requestId}`

## Request

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

operation defaults to status. reserve/claim/settle/close project only the exact eligible source operation. Recovery after lost commit/settle uses this same UUID, never a new charge or version.

## Path parameters

- `id` string, required
- `requestId` string, uuid, required

## Query parameters

- `operation` 'status' | 'reserve' | 'claim' | 'settle' | 'close'

## Response `200`

Exact lifecycle receipt; private, no-store

- ArtifactContentRequest
  - `purpose` 'consumer_artifact_content', required
  - `target_id` string, required
  - `request_id` string, uuid, required
  - `source_id` string, required
  - `source_namespace` 'agent-use', required
  - `owner_user_id` string, required
  - `actor` union, required
    - object
      - `kind` 'user', required
      - `user_id` string, required
    - object
      - `kind` 'publisher', required
      - `publisher_id` string, required
  - `credential_kind` 'personal' | 'consumer' | 'publisher', required
  - `consumer_client_id` string, nullable, required
  - `source_epoch` integer, required
  - `policy_version` unknown, required
  - `base_version` integer, required
  - `raw_sha256` string, required
  - `raw_size_bytes` integer, required
  - `media_type` string, required
  - `site` boolean, required
  - `restored_from` integer, nullable, required
  - `phase` 'pending' | 'claimed' | 'committed' | 'cancelled' | 'reclaimed', required
  - `version` integer, nullable, required
  - `revision_id` string, required
  - `generations_reclaimed` boolean, required
  - `eligible_operation` 'status' | 'reserve' | 'claim' | 'settle' | 'close', required

## Other responses

- `default`: Error { error: { code, message } }; changed facts are 409, unavailable recovery retains fences and capacity

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/artifacts/:id/mutations/:requestId/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)