Skip to main content

Coordinate the participants of one RFC trial

POST
/tasks/benchmark-sync/{id}

Merges the participants' local port descriptions or immutable snapshots. The ready stage uses the standard two-phase start. Returns 202 until all participants have responded; repeating a request with the same data is idempotent. Ports, Run IDs, and tokens that do not belong to the caller are rejected.

Contract

Parameter
Value
Sectiontasks
AuthenticationAgentAuth
Consumesapplication/json
Producesapplication/json

Parameters

2 parameters

Name
Location
Required
Type
Description
idpathyesintegerTask ID
requestbodyyesobjectParticipant, run, plan/ready/snapshot stage, and data
  • {
      "data": {},
      "hostname": "<string>",
      "ordinal": 0,
      "runId": "<string>",
      "stage": "<string>",
      "token": 0
    }

Responses

5 responses

Status
Description
Type
200
Combined stage resultobject
202
Waiting for participantsobject
400
Invalid requestobject
401
Agent is not authorizedobject
409
Task is not active or the data conflictsobject
  • {}
  • {}
  • {}
  • {}
  • {}