---
title: "Delete a deployment"
method: DELETE
path: "/v2/projects/{projectId}/endpoints/{endpointId}/deployments/{id}"
tags: ["DeploymentService"]
---

# Delete a deployment

`DELETE /v2/projects/{projectId}/endpoints/{endpointId}/deployments/{id}`

## Request

- Base URL: `https://api.together.ai`
- URL: `https://api.together.ai/v2/projects/{projectId}/endpoints/{endpointId}/deployments/{id}`
- Auth: HTTP bearer

Permanently deletes a deployment from its endpoint. Remove the deployment from live traffic first; use `etag` to reject the request if it changed after it was read.

## Path parameters

- `projectId` string, required: Project identifier.
- `endpointId` string, required: Endpoint identifier.
- `id` string, required: Deployment identifier.

## Query parameters

- `etag` string: Etag for optimistic concurrency. If set, the delete is rejected if the current etag does not match.

## Response `200`

OK

- DEDeleteResponse: Empty response returned after a successful delete operation.

## Other responses

- `default`: Default error response

## Changes

- **2026-10-22** `bb5257b3173a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/together/apis/together-apis/changes/v2/projects/:projectId/endpoints/:endpointId/deployments/:id/delete.md)

---

[API](https://skmtc.dev/together/apis/together-apis.md) - [All operations](https://skmtc.dev/together/apis/together-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/together/apis/together-apis/revisions/93438ddac711?raw)