---
title: "Delete an environment"
method: DELETE
path: "/api/v4/projects/{id}/environments/{environment_id}"
tags: ["environments"]
---

# Delete an environment

`DELETE /api/v4/projects/{id}/environments/{environment_id}`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/projects/{id}/environments/{environment_id}`
- Auth: none declared

Deletes an environment from a project. The environment must be stopped first.

## Path parameters

- `id` string, required
- `environment_id` integer, required

## Response `204`

Delete an environment

- APIEntitiesEnvironment: API_Entities_Environment model
  - `id` integer, required
  - `name` string, required
  - `slug` string, required
  - `external_url` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `tier` string, required
  - `project` APIEntitiesBasicProjectDetails, required: API_Entities_BasicProjectDetails model
    - `id` integer, required
    - `description` string, required
    - `name` string, required
    - `name_with_namespace` string, required
    - `path` string, required
    - `path_with_namespace` string, required
    - `created_at` string, date-time, required
    - `default_branch` string
    - `tag_list` string[], required
    - `topics` string[], required
    - `ssh_url_to_repo` string, required
    - `http_url_to_repo` string, required
    - `web_url` string, required
    - `readme_url` string
    - `forks_count` integer
    - `license_url` string
    - `license` APIEntitiesLicenseBasic
      - `key` string, required
      - `name` string, required
      - `nickname` string, required
      - `html_url` string, required
      - `source_url` string, required
    - `avatar_url` string, required
    - `star_count` integer, required
    - `last_activity_at` string, date-time, required
    - `visibility` string, required
    - `namespace` APIEntitiesNamespaceBasic, required
      - `id` integer, required
      - `name` string, required
      - `path` string, required
      - `kind` string, required
      - `full_path` string, required
      - `parent_id` integer, required
      - `avatar_url` string, required
      - `web_url` string, required
    - `custom_attributes` APIEntitiesCustomAttribute: API_Entities_CustomAttribute model
      - `key` string, required
      - `value` string, required
    - `repository_storage` string
  - `last_deployment` APIEntitiesDeployment: API_Entities_Deployment model
    - `id` integer, required
    - `iid` integer, required
    - `ref` string, required
    - `sha` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `user` APIEntitiesUserBasic, required: API_Entities_UserBasic model
      - `id` integer, required
      - `username` string, required
      - `public_email` string, required
      - `name` string, required
      - `state` string, required
      - `locked` boolean, required
      - `avatar_url` string, required
      - `avatar_path` string
      - `custom_attributes` APIEntitiesCustomAttribute[]
        - `key` string, required
        - `value` string, required
      - `web_url` string, required
    - `environment` APIEntitiesEnvironmentBasic, required: API_Entities_EnvironmentBasic model
      - `id` integer, required
      - `name` string, required
      - `slug` string, required
      - `external_url` string, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `deployable` APIEntitiesCiJob, required: API_Entities_Ci_Job model
      - `id` integer, required
      - `status` string, required
      - `stage` string, required
      - `name` string, required
      - `ref` string, required
      - `tag` boolean, required
      - `coverage` number, float, required
      - `allow_failure` boolean, required
      - `created_at` string, date-time, required
      - `started_at` string, date-time, required
      - `finished_at` string, date-time, required
      - `erased_at` string, date-time, required
      - `duration` number, float, required: Time spent running
      - `queued_duration` number, float, required: Time spent enqueued
      - `user` APIEntitiesUser, required
        - `id` integer, required
        - `username` string, required
        - `public_email` string, required
        - `name` string, required
        - `state` string, required
        - `locked` boolean, required
        - `avatar_url` string, required
        - `avatar_path` string
        - `custom_attributes` APIEntitiesCustomAttribute[]
          - `key` string, required
          - `value` string, required
        - `web_url` string, required
        - `created_at` string
        - `bio` string, required
        - `location` string, required
        - `linkedin` string, required
        - `twitter` string, required
        - `discord` string, required
        - `website_url` string, required
        - `github` string, required
        - `job_title` string, required
        - `pronouns` string, required
        - `organization` string, required
        - `bot` boolean, required
        - `work_information` string, required
        - `followers` string
        - `following` string
        - `is_followed` string
        - `local_time` string, required
      - `commit` APIEntitiesCommit, required: API_Entities_Commit model
        - `id` string, required
        - `short_id` string, required
        - `created_at` string, date-time, required
        - `parent_ids` string[], required
        - `title` string, required
        - `message` string, required
        - `author_name` string, required
        - `author_email` string, required
        - `authored_date` string, date-time, required
        - `committer_name` string, required
        - `committer_email` string, required
        - `committed_date` string, date-time, required
        - `trailers` object, required
        - `extended_trailers` object, required
        - `web_url` string, required
      - `pipeline` APIEntitiesCiPipelineBasic, required: API_Entities_Ci_PipelineBasic model
        - `id` integer, required
        - `iid` integer, required
        - `project_id` integer, required
        - `sha` string, required
        - `ref` string, required
        - `status` string, required
        - `source` string, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `web_url` string, required
      - `failure_reason` string
      - `web_url` string, required
      - `project` object, required
        - `ci_job_token_scope_enabled` string, required
      - `artifacts_file` APIEntitiesCiJobArtifactFile
        - `filename` string, required
        - `size` integer, required
      - `artifacts` APIEntitiesCiJobArtifact[], required
        - `file_type` 'archive' | 'metadata' | 'trace' | 'junit' | 'sast' | 'dependency_scanning' | 'container_scanning' | 'dast' | 'codequality' | 'license_scanning' | 'performance' | 'metrics' | 'metrics_referee' | 'network_referee' | 'lsif' | 'dotenv' | 'cobertura' | 'terraform' | 'accessibility' | 'cluster_applications' | 'secret_detection' | 'requirements' | 'coverage_fuzzing' | 'browser_performance' | 'load_performance' | 'api_fuzzing' | 'cluster_image_scanning' | 'cyclonedx' | 'requirements_v2' | 'annotations' | 'repository_xray' | 'jacoco' | 'sarif', required
        - `size` integer, required
        - `filename` string, required
        - `file_format` 'raw' | 'zip' | 'gzip', required
      - `runner` APIEntitiesCiRunner, required: API_Entities_Ci_Runner model
        - `id` integer, required
        - `description` string, required
        - `ip_address` string, required
        - `active` boolean, required
        - `paused` boolean, required
        - `is_shared` boolean, required
        - `runner_type` 'instance_type' | 'group_type' | 'project_type', required
        - `name` string, required
        - `online` boolean, required
        - `created_by` APIEntitiesUserBasic: API_Entities_UserBasic model
          - `id` integer, required
          - `username` string, required
          - `public_email` string, required
          - `name` string, required
          - `state` string, required
          - `locked` boolean, required
          - `avatar_url` string, required
          - `avatar_path` string
          - `custom_attributes` APIEntitiesCustomAttribute[]
            - `key` string, required
            - `value` string, required
          - `web_url` string, required
        - `created_at` string, date-time, required
        - `status` string, required
        - `job_execution_status` 'active' | 'idle', required
      - `runner_manager` APIEntitiesCiRunnerManager: API_Entities_Ci_RunnerManager model
        - `id` integer, required
        - `system_id` string, required
        - `version` string, required
        - `revision` string, required
        - `platform` string, required
        - `architecture` string, required
        - `created_at` string, required
        - `contacted_at` string, required
        - `ip_address` string, required
        - `status` string, required
        - `job_execution_status` 'active' | 'idle', required
      - `artifacts_expire_at` string, date-time, required
      - `archived` boolean, required
      - `tag_list` string[], required
    - `status` string, required
  - `state` string, required
  - `auto_stop_at` string, date-time, required
  - `cluster_agent` APIEntitiesClustersAgent: API_Entities_Clusters_Agent model
    - `id` integer, required
    - `name` string, required
    - `config_project` APIEntitiesProjectIdentity, required
      - `id` integer, required
      - `description` string, required
      - `name` string, required
      - `name_with_namespace` string, required
      - `path` string, required
      - `path_with_namespace` string, required
      - `created_at` string, date-time, required
    - `created_at` string, date-time, required
    - `created_by_user_id` integer, required
    - `is_receptive` boolean, required
  - `kubernetes_namespace` string
  - `flux_resource_path` string
  - `description` string, required
  - `auto_stop_setting` string, required

## Other responses

- `401`: Unauthorized
- `404`: Not found

---

[API](https://skmtc.dev/gitlab/apis/gitlab-api.md) - [All operations](https://skmtc.dev/gitlab/apis/gitlab-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gitlab/apis/gitlab-api/revisions/b234947ef3f2?raw)