AimableDocs
DocsAPI Reference
PATCH/v1/admin/mcp-servers/{server_id}

Update Mcp Server

Path Parameters

NameTypeRequiredDescription
server_idstring (uuid)Required

Headers

NameTypeRequiredDescription
X-API-KeystringOptional

Request Body

application/jsonRequired
display_nameobject
descriptionobject
auth_typeobject
oauth_client_idobject
oauth_client_secretobjectOAuth client secret — encrypted and stored
urlobject
commandobject
command_argsobject
env_varsobject
headersobject
credential_secret_idobject
api_keyobjectNew API key/token — replaces existing credential
statusobject

Request

curl -X PATCH '/api-proxy/v1/admin/mcp-servers/{server_id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "display_name": {},
  "description": {},
  "auth_type": {},
  "oauth_client_id": {},
  "oauth_client_secret": {},
  "url": {},
  "command": {},
  "command_args": {},
  "env_vars": {},
  "headers": {},
  "credential_secret_id": {},
  "api_key": {},
  "status": {}
}'

Response

200(generated)
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "slug": "string",
    "display_name": "string",
    "description": {},
    "transport_type": "string",
    "auth_type": "api_key",
    "icon_url": {},
    "url": {},
    "command": {},
    "status": "string",
    "status_message": {},
    "tool_count": 0,
    "last_discovered_at": {},
    "created_at": "2024-01-01T00:00:00Z",
    "updated_at": "2024-01-01T00:00:00Z"
  }
}

Error Responses