curl --request PUT \
  --url https://api.example.com/api/v1/platform/tenants/{tenant_id}/credentials/{client_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Id: <x-api-id>' \
  --header 'X-Api-Nonce: <x-api-nonce>' \
  --header 'X-Api-Signature: <api-key>' \
  --header 'X-Api-Timestamp: <x-api-timestamp>' \
  --data '
{
  "client_id": "client_001",
  "name": "Tenant 001 command client",
  "status": "ACTIVE",
  "allowed_clock_skew_seconds": 300,
  "replay_window_seconds": 300,
  "rotate_secret": true,
  "expires_at": null
}
'

{
  "client_id": "client_001",
  "tenant_id": "tenant_001",
  "name": "Tenant 001 command client",
  "status": "ACTIVE",
  "allowed_clock_skew_seconds": 300,
  "replay_window_seconds": 300,
  "secret": "returned_once_on_create_or_rotate",
  "expires_at": null,
  "request_id": "req-001"
}