Search the docs

Search guides, API endpoints and MCP tools.

Catalog

update_environment

Write grantIdempotent

Change an environment's slug, name, description or emoji. Only the fields given change; the class cannot. An archived environment cannot change. Returns the environment. Needs write access.

Inputs

environmentstringRequired

The environment's slug, such as staging.

slugstring

A new slug for the environment, such as preview.

namestring

The environment's display name, up to 80 characters, such as Staging.

descriptionnullable string

What the environment is for, up to 200 characters. null clears it.

emojinullable string

An emoji shown with the name, up to 8 characters, such as 🧪. null clears it.

tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "update_environment",    "arguments": {      "environment": "staging",      "description": "Release candidates with test data."    }  }}
POST/agent/v1/environments:update
curl -X POST https://api.qa.clankership.net/agent/v1/environments:update \  -H "Authorization: Bearer $CLANKER_AGENT_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "environment": "staging",    "description": "Release candidates with test data."  }'
The same call over the agent HTTP API. Set CLANKER_AGENT_TOKEN to an agent OAuth access token.