Skip to main content
POST
Add a participant to an open thread. The standard use is adding the courier at assignment — the customer_courier lane flips from waiting to active and the Supervisor briefs the courier with any context that matters (“leave at the gate, code 4411”). A thread holds one active participant per role; adding a second courier returns 409remove the first for reassignment.

Path

string
required
Thread ID (th_…) or your reference.

Request

string
required
customer, merchant, or courier.
string
required
Your ID for this person.
string
required
Name shown to other participants.
string
BCP-47 code for this participant’s reading language.

Response

object
The created participant with server ID (prt_…).
array
Updated lane states — the joining role’s lanes become active.