Update KYC Token Address

Update a KYC token address association for a token.

Endpoint: PUT /api/v1/integration/tokens/{token_id}/kyc-tokens/{id}

Authentication: Required (Bearer token)

Required Headers:

Authorization: Bearer <access_token>
X-Target-Server: integration
Content-Type: application/json

Path Parameters

Parameter	Type	Required	Description
token_id	string (UUID)	Yes	Token ID
id	string (UUID)	Yes	Distributor KYC Token ID

Request Body

All fields are optional. Only include the fields you want to update:

{
  "chain_id": 1,
  "hash": "0x81948129849128491824981294111",
  "is_approved": true
}

Request Parameters

Field	Type	Required	Description
chain_id	integer	No	Blockchain network ID (e.g., 1 = Ethereum Mainnet, 137 = Polygon)
hash	string	No	Transaction or contract hash
is_approved	boolean	No	Whether the KYC token address is approved

Response

Status: 200 OK

Returns the updated distributor KYC token object.

{
  "id": "e28cae58-0c9c-4f71-91b4-e567e06cc6a7",
  "distributor_id": "084a5159-1546-4ade-a7ba-956e0234a417",
  "kyc_address_id": "3b695a99-be80-4668-99af-254717524dd0",
  "token_id": "3c4da8b4-99e0-45ca-bb0b-221c3b1272b3",
  "chain_id": 1,
  "hash": "0x81948129849128491824981294111",
  "is_approved": true,
  "created_at": "2025-12-24T16:09:11.408342Z",
  "updated_at": "2025-12-24T16:09:11.408342Z"
}

Example cURL Request

curl -X PUT 'https://<base-url>/api/v1/integration/tokens/3c4da8b4-99e0-45ca-bb0b-221c3b1272b3/kyc-tokens/e28cae58-0c9c-4f71-91b4-e567e06cc6a7' \
  -H "Content-Type: application/json" \
  -H "X-Target-Server: integration" \
  -H "Authorization: Bearer <access_token>" \
  -d '{
    "chain_id": 1,
    "hash": "0x81948129849128491824981294111",
    "is_approved": true
  }'