cURL
curl --request PATCH \ --url https://control-plane.kubiya.ai/api/v1/environments/{environment_id} \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data ' { "name": "<string>", "display_name": "<string>", "description": "<string>", "tags": [ "<string>" ], "settings": {}, "status": "<string>", "execution_environment": { "env_vars": {}, "secrets": [ "<string>" ], "integration_ids": [ "<string>" ], "mcp_servers": {} } } '
{ "id": "<string>", "organization_id": "<string>", "name": "<string>", "display_name": "<string>", "description": "<string>", "tags": [ "<string>" ], "settings": {}, "status": "<string>", "created_at": "<string>", "updated_at": "<string>", "created_by": "<string>", "worker_token": "<string>", "provisioning_workflow_id": "<string>", "provisioned_at": "<string>", "error_message": "<string>", "temporal_namespace_id": "<string>", "active_workers": 0, "idle_workers": 0, "busy_workers": 0, "skill_ids": [], "skills": [], "execution_environment": {} }
Update an environment
Execution environment configuration - env vars, secrets, integration credentials, and MCP servers.
All string fields in mcp_servers support template syntax:
Show child attributes
Environment variables (key-value pairs)
Secret names from Kubiya vault
Integration UUIDs for delegated credentials
MCP (Model Context Protocol) server configurations. Supports stdio, HTTP, and SSE transports. All string values support template syntax.
Successful Response
Was this page helpful?