---
title: "Read exact retired-file reclamation progress [write]"
method: GET
path: "/artifacts/{id}/reclamation"
tags: ["artifacts"]
---

# Read exact retired-file reclamation progress \[write\]

`GET /artifacts/{id}/reclamation`

## Request

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

Actual retired owner's current unrestricted write bearer required even for this read. Durable progress only; missing responses never imply released capacity.

## Path parameters

- `id` string, required

## Query parameters

- `request_id` string, uuid, required

## Response `200`

Exact lifecycle receipt; private, no-store

- ArtifactReclamation
  - `purpose` 'consumer_artifact_reclamation', required
  - `target_id` string, required
  - `request_id` string, uuid, required
  - `owner_user_id` string, required
  - `actor_user_id` string, required
  - `phase` 'pending' | 'reclaimed', required
  - `revision_ids` string[], required
  - `pending_requests_closed` boolean, required
  - `bytes_reclaimed_revision_ids` string[], required
  - `source_closed_revision_ids` string[], required
  - `complete` boolean, 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/reclamation/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)