---
title: "Retire an inactive adoption intent [write]"
method: POST
path: "/artifacts/adoptions/{targetId}/cancel"
tags: ["artifacts"]
---

# Retire an inactive adoption intent \[write\]

`POST /artifacts/adoptions/{targetId}/cancel`

## Request

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

Requires an unrestricted personal owner write bearer or a platform-issued agent-use-web consumer bearer. Read-only, restricted, team, app, task, fixed-workspace and workspace-identity credentials are refused. Read and proof operations also require write scope. Ownership comes from the actual bearer and exactly one consumer identity mapping, never an input owner or email. The target stays inactive: no content is copied, no revision is committed and no writer is activated. Cancel canonical intent first, then cancel its source binding. Retirement preserves immutable history and prevents resurrection. A new attempt needs a new request_id.

## Path parameters

- `targetId` string, required

## Request body

- object
  - `request_id` string, required

## Response `200`

Retired intent

- InactiveArtifactAdoption
  - `purpose` 'consumer_artifact_inactive_adoption', required
  - `target_id` string, required
  - `request_id` string, required
  - `actor_user_id` string, required
  - `owner_user_id` string, required: Owner of this inactive canonical request, derived from its bearer. Requested source ownership is not established until source verification.
  - `credential_kind` 'personal' | 'consumer', required
  - `consumer_client_id` string, nullable, required
  - `source_namespace` 'agent-use', required
  - `source_id` string, required
  - `phase` 'adoption_pending', required
  - `retired` boolean, required
  - `policy_version` unknown, required
  - `verified` boolean, required: Provenance was observed at the source-locked read; this is not activation or a claim of current cross-database freshness.
  - `observed_snapshot` object, nullable, required: Server-measured snapshot at verification; any future activation must revalidate content, sharing and epoch.
    - `source_version` integer, required
    - `source_policy_revision` string, required
    - `binding_epoch` integer, required

## Other responses

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

## Changes

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

[Operation history](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/artifacts/adoptions/:targetId/cancel/post.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/0d435187cd55?raw)