Destroy an environment

Ends the environment and releases what it holds. Idempotent: an identifier this host does not have is 204, because the caller’s intent — that it be gone — is satisfied. Sessions bound to it are not deleted and their transcripts are untouched; each reports its environment gone and fails the tool calls that need it, rather than silently falling back to this machine. On a hosted home a bound conversation’s next message instead makes a container of its own, cloning again the repository the destroyed environment held.

DELETE /v1/environments/{environmentId}

Destroy an environment

cURL

curl --request DELETE \
  --url https://api.example.com/v1/environments/{environmentId} \
  --header 'Authorization: Bearer <token>'

400

{
  "code": "NRY-0002",
  "title": "Session not found",
  "message": "No session with id 6b9f6d2e-1c3a-4f5b-9d7e-2a8c4e6f0b1d exists on this host."
}

Autorizações

Authorization · string · header · obrigatório

Enforced on every transport, with no exempt operation. A person's request must carry a JWT issued by the configured identity provider, which the host verifies itself against that issuer's key set: signature, issuer, expiry, and the person and organisation it names. Requests without a valid one receive 401 NRY-0011 — except a request with no token on a laptop's socket from the OS user the kernel names as the host's own, which is that machine's user.

Parâmetros de caminho

environmentId · string · obrigatório

The environment's identifier. An environment's identifier, chosen by whoever creates it and unique on this host. It travels as one path segment, so its shape is bounded to what a path segment carries unchanged, exactly as a monitor's name is: a "/" would address no route and a "?" or "#" would end the segment early and address something else. One beginning conversation- is a hosted home's own, and a create naming it is 422.

Required string length: 1 - 64

Pattern: ^[A-Za-z0-9][A-Za-z0-9._-]*$

Resposta

204

Destroyed.