Update a domain API client
update_domain_clientUpdate a domain client's name, scopes, token lifetime, rate limit, or active state; requires confirm=true, and active:false blocks tokens reversibly without changing the secret.
Instructions
Changes a client's name, scopes, token lifetime, rate limit or active state. active:false refuses its tokens from the next request and is reversible. Never changes the secret (rotate_domain_client_secret). Requires confirm=true.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"domainId": "<domainId>",
"clientId": "<clientId>"
},
"name": "update_domain_client"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| active | No | ||
| scopes | No | Space-separated; replaces the list. | |
| confirm | No | Must be true to act. Omit/false returns a preview only. | |
| clientId | Yes | The client's id ("dcl_…") — from list_domain_clients. | |
| domainId | Yes | The domain's id — from list_domains. | |
| rateLimitPerMinute | No | Its own gateway allowance in requests per minute (1-6000). Every client of a site calls as the site's owner and shares one platform limit, so this keeps one of them from spending the others' share; past it the client gets 429 CLIENT_RATE_LIMIT for the rest of the minute. Omit to keep it; 0 removes it. | |
| tokenLifetimeMinutes | No |