Commands submit and wait for reassignment

POST /v2/commands/submit-and-wait-for-reassignment

Request

curl --request POST \
  --url 'http://localhost:7575/v2/commands/submit-and-wait-for-reassignment' \
  --header 'Authorization: Bearer $TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"reassignmentCommands":{"workflowId":"string","userId":"string","commandId":"string","submitter":"string","submissionId":"string","commands":[{}]},"eventFormat":{"filtersByParty":{},"filtersForAnyParty":{},"verbose":false}}'

200 response

{
  "reassignment": {
    "updateId": "string",
    "commandId": "string",
    "workflowId": "string",
    "offset": 0,
    "events": [
      {}
    ],
    "traceContext": {},
    "recordTime": "string",
    "synchronizerId": "string",
    "paidTrafficCost": 0
  }
}

JSON Ledger API

Commands submit and wait for reassignment

OpenAPISince 3.4Changed 3.5

Submits a single composite reassignment command, waits for its result, and returns the reassignment. Propagates the gRPC error of failed submission.

Protocol Details

Operation IDpostV2CommandsSubmit-and-wait-for-reassignment

AuthenticationBearer token

Published3.5

Inputs

Request body

application/json

reassignmentCommands · object · required

OpenAPI type: ReassignmentCommands.

eventFormat · object

OpenAPI type: EventFormat.

A format for events which defines both which events should be included and what data should be computed and included for them. Note that some of the filtering behavior depends on the TransactionShape, which is expected to be specified alongside usages of EventFormat.

Outputs

200

application/json

reassignment · JsReassignment · required

Complete view of an on-ledger reassignment.

400

text/plain

value · string · required

default

application/json

code · string · required

cause · string · required

correlationId · string

traceId · string

context · Map_String · required

resources · Tuple2_String_String[]

errorCategory · integer (int32) · required

grpcCodeValue · integer (int32)

retryInfo · string

definiteAnswer · boolean

History

Changed3.5

The POST /v2/commands/submit-and-wait-for-reassignment operation changed in this snapshot.

Introduced3.4

Request

curl --request POST \
  --url 'http://localhost:7575/v2/commands/submit-and-wait-for-reassignment' \
  --header 'Authorization: Bearer $TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"reassignmentCommands":{"workflowId":"string","userId":"string","commandId":"string","submitter":"string","submissionId":"string","commands":[{}]},"eventFormat":{"filtersByParty":{},"filtersForAnyParty":{},"verbose":false}}'

200 response

{
  "reassignment": {
    "updateId": "string",
    "commandId": "string",
    "workflowId": "string",
    "offset": 0,
    "events": [
      {}
    ],
    "traceContext": {},
    "recordTime": "string",
    "synchronizerId": "string",
    "paidTrafficCost": 0
  }
}