environments

Delete an environment (cascade teardown)

delete/v1/environments/{env}

Request

  • Base URL: https://api.typenode.ai
  • URL: https://api.typenode.ai/v1/environments/{env}
  • Auth: HTTP bearer

Path parameters

envstring required

The environment NAME (lowercase slug), never its id. GET /v1/environments returns both; passing the id here is rejected with 400.

Query parameters

expected_environment_idstring uuid

The immutable environment UUID the caller reviewed; a name that now resolves to a different id is refused with no effect.

Headers

Idempotency-Keystring uuid required

A required UUID v4 identifying this exact environment deletion intent.

Response

The deleted environment name.

deletedtrue required
namestring required

Changes

No recorded changes to this operation across all 2 revisions of this API.