Relation Operations

Retry Relation Operation

Retries a `failed` relation operation: the same operation goes back to `pending` and its chain jobs that did not complete are scheduled again. The chains are rebuilt from the current IB tree, not from the one at the time of the failure; rewards of trades processed in between are not recalculated. The failure the retry replaces is appended to the operation's `retries`, with the acting-user headers naming who retried (the B2Core system without them). No request body is needed; an empty body, `[]` or `{}` is accepted. Available once operations carry the `retries` key. Back office only: App tokens receive `403`, whatever their access level.

POST
/relation-operations/{operationId}/retry

Authorization

backOfficeToken
AuthorizationBearer <token>

Shared static token of the B2Core back office, configured for the IB module (not issued by POST /tokens). Send it as Authorization: Bearer <token>. Back-office-only operations require it; App tokens receive 403 there. On back-office requests the acting-user headers (X-B2Core-User-Id, X-B2Core-User-Type, X-B2Core-User-Email) name the B2Core user who acts, recorded as the initiator of relation operations and reassignments; requests with App tokens ignore them.

In: header

Path Parameters

operationId*string
Formatuuid

Header Parameters

X-B2Core-User-Id?string

B2Core ID of the back-office user who acts. Honored on back-office requests only, and only together with a valid X-B2Core-User-Type and a non-empty X-B2Core-User-Email; otherwise the three headers are ignored and the initiator is the B2Core system.

Match^[0-9]+$
X-B2Core-User-Type?string

Kind of the B2Core user named by X-B2Core-User-Id

Value in

  • "admin"
  • "client"
X-B2Core-User-Email?string

Email of the B2Core user named by X-B2Core-User-Id

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/relation-operations/497f6eca-6276-4993-bfeb-53cbbbba6f08/retry"
{  "operationId": "3051932a-fdd2-48fa-b330-7e7d41535969"}
{  "message": "string",  "code": "string",  "errors": {    "property1": [      "string"    ],    "property2": [      "string"    ]  },  "details": [    {      "field": "string",      "issue": "string"    }  ]}
{  "error": {    "message": "relation operations are available to the back office only",    "code": "forbidden"  }}
{  "error": {    "message": "relation operation not found",    "code": "not_found"  }}
{  "error": {    "message": "Only failed relation changes can be retried.",    "code": "not_failed"  }}