Skip to content
/
Deactivate a virtual MCP

Deactivate a virtual MCP

Request

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

Deactivates a virtual MCP, transitioning it from the ACTIVE status to the INACTIVE status. The virtual MCP must be in the ACTIVE status to be deactivated.

Path
virtualMcpServerIdstringrequired

ID of a virtual MCP

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

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