TEteaflask
authed

Rename an MCP server

Renames a server in the dashboard; its handle, and so its agents' tool names, never change.

patch/api/v1/org-mcp-servers/{server_id}

Request

  • Base URL
    https://api.teaflask.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.teaflask.com/api/v1/org-mcp-servers/{server_id}
  • Auth
    none declared

Path parameters

server_idstring uuid required

The server's id, as list_org_mcp_servers returns it.

Request body

display_namestring required

The new name; control characters are removed and it is cut to 60 characters.

expected_versioninteger nullable

The version you read; a server changed since is refused.

Response

Successful Response

idstring uuid required

The server's id.

handlestring required

The server's short name in agent tool names; it never changes.

display_namestring required

The server's name in the dashboard.

hoststring required

The host name of the server's address.

state'active' | 'needs_reconnect' | 'failed' required
last_errorstring nullable required

Why the server last failed to connect, or null.

sign_in'oauth' | 'token' | 'none' required
header_namesstring[] required

The names of the headers carrying its access token.

tool_countinteger required

How many tools the server lists now.

new_tool_countinteger required

How many of those arrived after the server was added.

first_listed_atstring date-time required

When the server was added.

tools_refreshed_atstring date-time required

When its tool list was last read.

removed_atstring date-time nullable required

When the server was removed, or null while it is live.

created_atstring date-time required

When the server was created.

versioninteger required

Pass back as expected_version when renaming the server.

Changes

No recorded changes to this operation across all 1 revision of this API.