ConnectCloud Developers

Restore an instance to an earlier state version (tenant:settings:write)

POST /api/workflow/v1/tasks/{instanceId}/recover

Module: Workflow · operationId: restoreInstanceVersion · Tag: Instances · Auth: access token (Authorization: Bearer <accessToken>)

Saves the state of revision versionId as a new revision and writes it to trade, which locks or releases the transaction accordingly. 409 when another instance is already active for the transaction, when the version belongs to a start that never ran, or on a concurrent change.

Parameters

Name In Type Required Description
versionId query integer (int64) yes Revision to restore (versionId from the version list)
instanceId path string (uuid) yes Instance id (guid)

Responses

  • 200 Restored (no body)
  • 400 Error (application/json)
  • 401 Missing or invalid token (unauthorized) (application/json)
  • 403 Error (application/json)
  • 404 Error (application/json)
  • 409 Error (application/json)
  • 500 Error (application/json)

Example request

curl -X POST 'https://api.mbcom.cloud/api/workflow/v1/tasks/3f9c2a1e-8b7d-4c6e-a5f4-1d2b3c4e5f60/recover?versionId=3' \
  -H "Authorization: Bearer $ACCESS_TOKEN"

View as Markdown · Interactive reference · OpenAPI