Skip to main content
PUT
/
v2
/
client-ids
/
{id}
Update a client ID
curl --request PUT \
  --url https://api.stage.request.network/v2/client-ids/{id} \
  --header 'Content-Type: application/json' \
  --data '{
  "label": "My Client ID",
  "allowedDomains": [
    "https://example.com"
  ]
}'
{
  "id": "<string>",
  "clientId": "<string>",
  "label": "<string>",
  "allowedDomains": [
    "<string>"
  ],
  "feePercentage": "<string>",
  "feeAddress": "<string>",
  "status": "<string>",
  "updatedAt": "<string>"
}

Headers

​
x-api-key
string

API key for authentication (optional if using session)

​
Authorization
string

Bearer token for session authentication (optional if using API key)

Example:

"Bearer <session-token>"

Path Parameters

​
id
string
required

Client ID internal identifier

Example:

"123"

Body

application/json
​
label
string
Required string length: 1 - 100
​
allowedDomains
string<uri>[]

List of allowed domain origins (normalized)

Required array length: 1 - 10 elements
​
feePercentage
string | null

Fee percentage (e.g., '1' = 1%, '2.5' = 2.5%). If set to '0', allows API request fees to take precedence. If set to any other value, overrides any fee passed via API. Set to null to unset.

Minimum length: 1
​
feeAddress
string | null

Wallet address to receive fees. Required if feePercentage is set. Set to null to unset.

​
status
enum<string>
Available options:
active,
inactive,
revoked

Response

Client ID updated successfully

​
id
string
​
clientId
string
​
label
string
​
allowedDomains
string[]
​
feePercentage
string | null
​
feeAddress
string | null
​
status
string
​
updatedAt
string