Issue Agency API Key
agency_profile_issue_keyCreates a scoped API key for the current user in an agency and returns its secret once. Use it to issue keys with specific permissions while respecting owner, billing, and delegation limits.
Instructions
Creates a new API key for yourself in this agency, limited to the requested scopes, and returns the secret once. Readers cannot get write scopes, only the agency owner can get billing:write, and a delegated key cannot issue a key broader than itself. Each call creates another key (up to 20 active per user).
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": {
"partnerId": "<partnerId>",
"name": "<name>",
"scopes": "<scopes>"
},
"name": "agency_profile_issue_key"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | A label for the key. | |
| scopes | Yes | Scopes to grant, from the supported agency set (for example workspaces:read, agents:write, billing:read). | |
| partnerId | Yes | The agency (partner) workspace ID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when success is false | |
| receipt | No | ||
| success | Yes | Whether the tool completed successfully |