---
title: "Request an inactive legacy artifact adoption [write]"
method: POST
path: "/artifacts/adoptions"
tags: ["artifacts"]
---

# Request an inactive legacy artifact adoption \[write\]

`POST /artifacts/adoptions`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/artifacts/adoptions`
- 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. This immutable intent does not reserve a source identity before source ownership is proven. Reuse request_id for an identical retry; a changed or retired intent returns 409.

## Request body

- object
  - `request_id` string, required
  - `source_namespace` 'agent-use', required
  - `source_id` string, required

## Response `201`

Inactive request

- 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/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)