Skip to main content
DELETE
Archive an MCP server
Archives the server. Its /v1/mcp/{slug} route stops resolving, and calls to it are refused rather than served from a stale upstream. Requires the delete capability on ai_gateway. See the control-plane overview for authentication, the {data, meta} envelope, pagination and error types.

Authorizations

Authorization
string
header
required

OAuth 2.1 authentication — recommended for new integrations. Access tokens (kc_ prefix) are minted at the root-host token endpoint https://api.knoxcall.com/oauth/token and passed as Authorization: Bearer <access_token>. Public clients must use PKCE with the authorization_code grant; confidential clients may use client_credentials. The first-party SDKs and the knoxcall login CLI handle token minting, caching, refresh, and DPoP for you.

Path Parameters

id
string<uuid>
required

The MCP server UUID.

Response

The archived server id and status.

data
object
meta
object

Metadata included with every API response.