create_key
Create another API key on your account, for example one per agent or machine, so you can revoke one without touching the others. name is up to 60 characters.
Give the key only what it needs. scopes: any of "read" (read runs, hooks, keeps,
usage), "write" (keep, reject, undo, chat), "research" (start runs, which spend
credits), "admin" (manage keys, delete the account); all four when left out. An agent
that finds hooks needs ["read", "write", "research"]. credit_limit: the most credits
runs started with this key may spend over its life, 1 to 100000 (a run then reserves
at most what is left). expires_in_days: 1 to 365; the key then stops working (401
key_expired).
The new key is in this result once and never again: store it now. Needs admin. An
account holds at most 10 active keys (409 beyond) and may create 20 per hour by
default (429 beyond). Free.
Next step: use the returned api_key; revoke old ones with revoke_key.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_key"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| scopes | No | ||
| api_key | No | ||
| credit_limit | No | ||
| expires_in_days | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |