Create processing result output version¶

Creates a revision for the specified product output block. When modifying concurrently, bring the expected revision to avoid overwriting other revisions.

HTTP
POST $CLOUDSIGMA_API_BASE/lineage/artifacts/{artifact_id}/blocks/{block_id}/revisions

Before you call this API¶

Configure the regional API endpoint and authentication, and select the target workspace.

Request¶

Input examples

Shell
curl -X POST "$CLOUDSIGMA_API_BASE/lineage/artifacts/$ARTIFACT_ID/blocks/$BLOCK_ID/revisions" \
  -H "X-API-Key: $CLOUDSIGMA_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "use_current_effective": true,
    "expected_effective_set_version": 3,
    "revision_content_payload": "修订后的内容"
  }'

Parameter reference

Request body

Field	Type	Description
`base_revision_id`	string	The revision ID to base the new revision on.
`use_original`	boolean	Use original content as base.
`use_current_effective`	boolean	Use the currently active revision as the basis.
`expected_effective_set_version`	integer	The expected effective revision set version.
`revision_content_payload`	string	New revision content.
`patch_json`	string	Revision patch JSON.

Successful response¶

When the request is successful, the data of this operation is returned. Just because the write or run request has been accepted does not mean that the subsequent processing has been completed; please confirm the result based on the return status or subsequent query.

The response fields are as follows.

Response example

JSON
{
  "code": "OK",
  "msg": "OK",
  "data": {"artifact_id": "art-001", "block_id": "block-001", "revision": {}}
}

Field reference

Field	Type	Description
`data.artifact_id`	string	Product ID.
`data.block_id`	string	Output block ID.
`data.revision`	object	The newly created revision.

Error response¶

Response example

JSON
{
  "code": "ErrParamInvalid",
  "msg": "请求参数无效",
  "data": null
}

Field reference

Field	Type	Description
`code`	string	Error code.
`msg`	string	Readable error message.
`data`	null	`null` in an error response.

Last updated on Sep 15, 2026