---
title: "Deprovision an ephemeral environment for a specific project"
method: POST
path: "/spaces/{spaceIdentifier}/projects/{projectId}/environments/ephemeral/{environmentId}/deprovision"
tags: ["EphemeralEnvironments"]
---

# Deprovision an ephemeral environment for a specific project

`POST /spaces/{spaceIdentifier}/projects/{projectId}/environments/ephemeral/{environmentId}/deprovision`

## Request

- Base URL: `https://demo.octopus.app/api`
- URL: `https://demo.octopus.app/api/spaces/{spaceIdentifier}/projects/{projectId}/environments/ephemeral/{environmentId}/deprovision`
- Auth: one of:
  - API key in header `X-Octopus-ApiKey`
  - API key in query parameter `ApiKey`
  - API key in header `X-NuGet-ApiKey`

## Path parameters

- `spaceIdentifier` string, required
- `projectId` string, required
- `environmentId` string, required

## Response `200`

Deprovision an ephemeral environment response

- DeprovisionEphemeralEnvironmentForProjectResponse
  - `DeprovisioningRun` EphemeralEnvironmentRunbookRun
    - `RunbookRunId` string, required
    - `TaskId` string, required

## Other responses

- `400`: Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404`: Not found. One or more of the entities involved in the operation was not found.

---

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