---
title: "Observe exact source workspace lifecycle"
method: GET
path: "/consumer/artifact-workspace-state"
tags: ["artifacts"]
---

# Observe exact source workspace lifecycle

`GET /consumer/artifact-workspace-state`

## Request

- Base URL: `https://api.agentsky.dev/v1`
- URL: `https://api.agentsky.dev/v1/consumer/artifact-workspace-state`
- Auth: HTTP bearer

Canonical negative lifecycle/provenance protocol, not a content/edit grant or general user-info API. Same actual write caller and concrete source/request/epoch/placement incarnation are checked. proof=caller accepts only source_id/request_id/source_epoch/proof and returns one purpose-bound callback identity/ceiling; it terminates the callback without acquiring leases. Normal proof is a lifecycle observation with opaque source lease keys, never reusable positive permission. purpose defaults to artifact_workspace_write; workspace_reference_write uses explicit real placement and a stable opaque reference key without a fabricated source identity, protecting incarnation/recreation races. ASP is accepted only for its existing concrete publisher source path. App/general system credentials are refused.

## Query parameters

- `purpose` 'artifact_workspace_write' | 'workspace_reference_write'
- `placement_slug` string
- `placement_created_at` string, date-time
- `extra_placement_slug` string
- `extra_placement_created_at` string, date-time
- `session_id` string
- `source_id` string
- `request_id` string, uuid
- `source_epoch` integer
- `proof` 'caller'
- `publisher_id` string
- `shared_token` string

## Response `200`

Exact lifecycle receipt; private, no-store

- unknown

## 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/consumer/artifact-workspace-state/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/0d435187cd55?raw)