---
title: "Delete Organization Environment"
method: DELETE
path: "/api/v3/meta/orgs/{orgId}/environments/{environmentId}"
tags: ["Environments"]
---

# Delete Organization Environment

`DELETE /api/v3/meta/orgs/{orgId}/environments/{environmentId}`

## Request

- Base URL: `https://app.nocodb.com`
- URL: `https://app.nocodb.com/api/v3/meta/orgs/{orgId}/environments/{environmentId}`
- Auth: one of:
  - API key in header `xc-token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/nocodb/apis/nocodb-v3/docs/api/v3/meta/orgs/:orgId/environments/:environmentId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete an organization environment. All per-environment integration configuration overrides bound to it — across every workspace under the organization — are removed as well. The built-in environments (`production` / `staging`) cannot be deleted.

Requires **Org Owner** role. Available on cloud-hosted plans with organizations.

**Note**: Environment APIs are available only with self-hosted **Enterprise** plans and cloud-hosted plans. Creating custom environments requires a plan that includes the custom-environments feature.

## Path parameters

- `orgId` string, required
- `environmentId` string, required

## Response `200`

Environment deleted successfully

- boolean

## Other responses

- `400`: Bad request.
- `404`: Environment not found.
- `500`: The server encountered an unexpected error while processing the request.

## Changes

- **2026-10-13** `2ba4267a99d7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nocodb/apis/nocodb-v3/changes/api/v3/meta/orgs/:orgId/environments/:environmentId/delete.md)

---

[API](https://skmtc.dev/nocodb/apis/nocodb-v3.md) - [All operations](https://skmtc.dev/nocodb/apis/nocodb-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/nocodb/apis/nocodb-v3/revisions/62a735aaf849?raw)