Skip to navigation

Import End User State

View as Markdown

Import a versioned product snapshot atomically, preserving correction provenance.

The cell must already exist. Every file requires expectedEtag (null for an absent destination). Reusing an importId requires the identical manifest. The digest is SHA-256 of canonical JSON {sourceRevision, files}, with sorted keys, compact separators and the supplied file order. Private layers are accepted as input but are never returned in the receipt or end-user view.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

project_idstringRequired
agent_slugstringRequired
tenant_idstringRequired1-128 characters
user_idstringRequired1-128 characters

Request

This endpoint expects an object.
digeststringRequiredformat: "^[0-9a-f]{64}$"
fileslist of objectsRequired
importIdstringRequiredformat: "^[A-Za-z0-9_.-]+$"1-128 characters
sourceRevisionstringRequired1-256 characters

Response

Successful Response
digeststring
importIdstring
pathslist of strings
sourceRevisionstring
evaluationStatusenum or nullOptional
Allowed values:

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error