Skip to content
Okta for AI Agents
/
Workload Principals
/
/
Delete a virtual MCP

Delete a virtual MCP

Request

OAuth 2.0 scope:
  • okta.resourceServers.virtualMcpServers.manage
Admin roles:
  • SUPER_ADMIN

Deletes a virtual MCP. You can't delete a virtual MCP that has the ACTIVE status.

Path
virtualMcpServerIdstringrequired

ID of a virtual MCP

Example:wlp1aB2cD3eF4gH5iJ6k
DELETE
/workload-principals/api/v1/virtual-mcp-servers/{virtualMcpServerId}
curl -i -X DELETE \
  https://subdomain.okta.com/workload-principals/api/v1/virtual-mcp-servers/wlp1aB2cD3eF4gH5iJ6k

Responses

Accepted

Headers
Locationstring, (uri)required

URL to poll for operation status. See AI Agent Operations.

Example:"https://{yourOktaDomain}/workload-principals/api/v1/operations/op-1a2b3c4d"
Response
No content