deleteDelete an environment

Deletes the environment and cascades to its deployments and routings. Returns 409 if linked execution history prevents deletion; nothing is deleted in that case. Deletion is idempotent: an absent ID in the active workspace also returns 204 with no response body.

Required service-token scope: environment:delete. End-user access is checked against workspace policies. Send a Bearer token and the X-Workspace-Id header.

curl --request DELETE \
  --url https://api.test.neobits.ai/logic/v1/environments/019991b1-0000-7000-8000-000000000002 \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'X-Workspace-Id: 019991b1-0000-7000-8000-000000000001'

Request

Headers

  • Authorization•string

    Bearer token authentication using OAuth 2.0 client credentials flow.

  • X-Workspace-Id•string<uuid>

    Active workspace UUID. The authenticated principal must have access to this workspace.

Params (path)

  • id•string<uuid>

    Environment identifier.

Response

No response body or headers defined for status 204