Rename tool
Rename a tool. The DB RPC atomically renames the tool and repoints every other tool's `requires` precondition that named it, in one transaction. **This is the only way to change a tool's name**, never use `delete_tool` and re-add, which throws away the endpoint, headers, params, mock and follow-up config. Use it to clear a `tool-dup-name` or `tool-name-empty` publish error. The system prompt is NOT rewritten: if the prompt mentions the old name, fix that separately with `edit_system_prompt`. Returns `requiresUpdated`, the number of other tools whose preconditions were repointed.
Authorization
bearerAuth A personal access token from Settings > API tokens.
In: header
Header Parameters
A key you choose, such as a UUID, that makes this POST safe to retry. Within 24 hours the same key and request answers with the first successful answer and runs nothing, the same key with a different request answers 422 idempotency_key_reused, and a key whose request is still running answers 409 idempotency_key_in_use. A failed request keeps nothing, so the same key runs it again.
1 <= length <= 255Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/operations/rename_tool" \ -H "Content-Type: application/json" \ -d '{ "oldName": "string", "newName": "string", "agent": "string" }'{}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}{
"type": "http://example.com",
"title": "string",
"status": 0,
"detail": "string",
"code": "string",
"errors": [
{
"path": "string",
"message": "string"
}
],
"estimate": {},
"retryAfterSeconds": 0
}Remove trusted caller POST
Stop trusting a server added with add_trusted_caller, by its id from list_trusted_callers. Its next request is refused as untrusted_caller. Needs owner or admin.
Rename variable POST
Rename a per-agent variable. The DB RPC atomically rewrites every `{{old_name}}` reference inside the draft's system prompt, tool URLs, and tool headers in one transaction. **Always use this when the user wants a different variable name**, never call `delete_variable` + `set_plain_variable`, which would orphan every reference and fail the publish validator. Returns `refsUpdated` so you can tell the user how many places were rewritten.