artifacts

Commit exact raw bytes to a prepared revision [write]

Changed on

Canonical base64 must exactly match prepared hash and size. Current policy/edit permission, base CAS and the exact source claim are rechecked at commit. Revoke-first wins; stale base is 409 without silent rebase.

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

Path parameters

idstring required
requestIdstring uuid required

Request body

content_base64string byte required

Response

Exact lifecycle receipt; private, no-store

purpose'consumer_artifact_content' required
target_idstring required
request_idstring uuid required
source_idstring required
source_namespace'agent-use' required
owner_user_idstring required
credential_kind'personal' | 'consumer' | 'publisher' required
consumer_client_idstring nullable required
source_epochinteger required
policy_versionunknown required
base_versioninteger required
raw_sha256string required
raw_size_bytesinteger required
media_typestring required
siteboolean required
restored_frominteger nullable required
phase'pending' | 'claimed' | 'committed' | 'cancelled' | 'reclaimed' required
versioninteger nullable required
revision_idstring required
generations_reclaimedboolean required
eligible_operation'status' | 'reserve' | 'claim' | 'settle' | 'close' required

Changes