Create a domain API client
create_domain_clientCreates an API client on a domain. The reply's clientSecret is shown EXACTLY ONCE — surface it to the user immediately — with the token URL and a ready-to-run curl.
Instructions
Creates an API client on a domain. The reply's clientSecret is shown EXACTLY ONCE — surface it to the user immediately — with the token URL and a ready-to-run curl. A caller then POSTs grant_type=client_credentials to that URL and sends the token as Authorization: Bearer to an endpoint whose authMode is jwt or apiKeyOrJwt (update_endpoint). Requires confirm=true — call WITHOUT confirm first to preview.
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>"
},
"name": "create_domain_client"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | What the client is, e.g. "Billing worker". | |
| scopes | No | Space-separated scopes it may be granted, e.g. "orders:read orders:write". | |
| confirm | No | Must be true to act. Omit/false returns a preview only. | |
| 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 for none. | |
| tokenLifetimeMinutes | No | How long its tokens last. Omit for the default. |