Deletes an API MCP service.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
openapiexplorer:DeleteApiMcpServer |
delete |
*ApiMcpServer
|
None | None |
Request syntax
DELETE /apimcpserver HTTP/1.1
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| clientToken |
string |
No |
A client-generated token that you must use to ensure request idempotence. The token must be unique for each request, contain only ASCII characters, and be no longer than 64 characters. Using a UUID is recommended. The token is valid for 3 days. |
123e4567-e89b-12d3-a456-426655440000 |
| id |
string |
Yes |
The ID of the API MCP service. |
v6ZZ7ftCzEILW*** |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response. |
||
| requestId |
string |
The request ID. |
9BFC4AC1-6BE4-5405-BDEC-CA288D404812 |
Examples
Success response
JSON format
{
"requestId": "9BFC4AC1-6BE4-5405-BDEC-CA288D404812"
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | Missing.Id | Id is mandatory for this action. | |
| 400 | IdempotentParameterMismatch | The request uses the same client token as a previous request but with different parameters. Client tokens should not be reused across non-identical requests. Each unique request must have a distinct client token. | The request used the same client token as the previous request, but with different parameters. Do not reuse the same token in requests with different parameters. Each request must use a unique token. |
| 400 | InvalidParam.ClientToken | The specified client token is not valid. | The idempotent parameter is incorrect, please check. |
| 403 | OperationNotAllowed.SystemServer | System type servers are not allowed to be updated or deleted. | System-level services do not allow update or delete operations. |
| 404 | NotFound.ApiMcpServer | Specified MCP server not found. | The MCP service with the specified ID does not exist. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.