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

Activate a virtual MCP

Request

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

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

Path
virtualMcpServerIdstringrequired

ID of a virtual MCP

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

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