Confirm trader acceptance - Tradara

POST /v1/firm-control/traders/acceptance/confirm

operationId: confirmTraderAcceptance Activates a trader relationship after the user has accepted firm terms. Until acceptance is confirmed, orders on the resulting accounts are rejected.

Body

Field	Required	Notes
`user_id`	yes	Trader user UUID.
`firm_id`	no	Required when `X-Firm-ID` is absent.

Example

curl -X POST "$TRADARA_BASE_URL/v1/firm-control/traders/acceptance/confirm" \
  -H "X-Tradara-Api-Key: $TRADARA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "user_id": "8e9ad12c-2b1c-4e9a-9d3b-5e6c7a0d1f23" }'

Response — `200 OK`

Returns the activated FirmRelationship.

{
  "id": "rel_01HW...",
  "firm_id": "8f4a1d6e-2b1c-4e9a-9d3b-5e6c7a0d1f23",
  "user_id": "8e9ad12c-2b1c-4e9a-9d3b-5e6c7a0d1f23",
  "relationship_type": "TRADER",
  "status": "ACTIVE",
  "invited_email": "[email protected]",
  "invitation_token_hash": "",
  "invitation_expires_at": "",
  "created_at": "2026-06-26T15:00:00Z",
  "updated_at": "2026-06-26T16:00:00Z"
}

Errors

HTTP	Meaning
`400`	Missing `user_id`.
`404`	Relationship not found for `(firm_id, user_id)`.
`502`	Downstream relationship service unreachable.