For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/institutional/patch-clients-cefi.md.

Update settings

PATCH
/v1/cefi/clients

Update client level settings.

Authorization

JWT
headerAuthorizationBearer <JWT>

Present a True Markets-issued JWT access token as Authorization: Bearer <token>, together with x-truex-auth-timestamp (current Unix seconds, which guards against replays). No request signing is required.

Obtain a token pair by exchanging a signed challenge for your registered ES256 (EC P-256) API key at POST /v1/auth/api-key/token (see the Auth API); the same token is issued by the standard sign-in flows.

The token must carry a client_id claim, which scopes every request to your CeFi client. The claim is present only once your account is enabled for CeFi trading; a JWT without a client_id claim is rejected with 401 Unauthorized.

Header Parameters

x-truex-auth-timestamp*string

Timestamp when request was made in seconds since epoch. Must be no older than 15 seconds and no more than 1 second in the future. It guards against replayed requests.

Request Body

Client settings context.

application/json
  1. body
id*string
Match^[1-9][0-9]*$
info?

Response Body

Successful operation.

application/json
  1. response
[index: integer]?
Example Request
curl -X PATCH 'https://api.truex.co/v1/cefi/clients' \  -H 'x-truex-auth-timestamp: string' \  -H 'Content-Type: application/json' \  -d '{  "id": "78901949710270469"}'
Example Response
[  {    "id": "78901949710204932",    "status": "ACTIVE",    "info": {      "organization_id": "ed671d2b-bb9e-4cf5-9eb4-71b6db672207",      "mnemonic": "CLIENT1",      "type": "INDIVIDUAL",      "maker_fee_tier": 1,      "taker_fee_tier": 2,      "self_trade_prevention": "CANCEL_AGGRESSIVE"    },    "controls": {      "rate_limit_tier": 0,      "instrument_entitlements": [        "SPOT"      ],      "flags": 0    }  }]