---
title: "Delete a dynamic segment"
method: DELETE
path: "/assets/{asset_id}/dynamic-segments/{segment_id}"
tags: ["DynamicSegments"]
---

# Delete a dynamic segment

`DELETE /assets/{asset_id}/dynamic-segments/{segment_id}`

## Request

- Base URL: `https://enterprise.knak.io/api/published/v1`
- URL: `https://enterprise.knak.io/api/published/v1/assets/{asset_id}/dynamic-segments/{segment_id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/knak/apis/knak-enterprise-api/docs/assets/:asset_id/dynamic-segments/:segment_id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete a [dynamic segment](#tag/dynamic_segment) scoped to an asset.
Requires the `local_dynamic_segments` permission. Global segments cannot be deleted through an asset route and return 422.

## Path parameters

- `asset_id` string, required
- `segment_id` string, required

## Response `204`

No Content. The segment and its platform segments were deleted.

## Other responses

- `401`: Unauthenticated
- `403`: Unauthorized
- `404`: Not Found. The segment does not exist, does not belong to this asset, or the asset belongs to another company.
- `422`: Unprocessable Entity. The segment is global, or the asset is not an email.

---

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