---
title: "Delete a specific segment"
method: DELETE
path: "/api-offers/segment/{segmentId}"
tags: ["Segment"]
---

# Delete a specific segment

`DELETE /api-offers/segment/{segmentId}`

## Request

- Base URL: `https://live.copilot.fabric.inc`
- URL: `https://live.copilot.fabric.inc/api-offers/segment/{segmentId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fabric/apis/offers-v2/docs/api-offers/segment/:segmentId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete a specific segment by segmentId

## Path parameters

- `segmentId` number, required

## Headers

- `x-site-context` string, required

## Response `200`

OK

- DeleteSegmentResponse
  - `_id` string: fabric internal database ObjectId of the record
  - `segmentId` number: System generated unique ID of the segment
  - `name` string: Name of segment
  - `value` string[]: Array of segment value
  - `deleted` boolean: true: segment is deleted<br /> false: segment is not deleted
  - `createdAt` string, date-time: Creation date of the record
  - `updatedAt` string, date-time: Last updated date of the record

## Other responses

- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/fabric/apis/offers-v2.md) - [All operations](https://skmtc.dev/fabric/apis/offers-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/fabric/apis/offers-v2/revisions/da2bd742b9bc?raw)