User

These endpoints describe and update the user behind the token. The most useful one is PUT /me/operation-mode, which sets the reconcile/passthrough mode for every account you own. All endpoints require Authorization: Bearer <jwt>.

Get the current user

Use this endpoint to read your own user record, including the operation mode that applies to all your accounts.

GET /me

Response 200 OK:

{
  "id": "uuid",
  "email": "you@example.com",
  "name": "Your Name",
  "operation_mode": "reconcile"
}

• operation_mode is "reconcile", "passthrough", or null when you have not picked a mode yet.

Set the operation mode

Use this endpoint to switch your user-wide operation mode. The change applies to every account you own: matching turns on or off everywhere on your next cycle.

PUT /me/operation-mode
Content-Type: application/json

Request body:

{ "mode": "reconcile" }

• mode - required. "reconcile" or "passthrough".

Responses:

• 200 OK

  { "operation_mode": "reconcile" }

• 400 Bad Request - the body is missing mode or its value is not one of the allowed strings.

See Operation modes for what each mode does, and Account settings for the per-account fields that interact with it (like pending_orders_endpoint).