---
title: "Updates a segment by its public ID for an import"
method: PATCH
path: "/imports/{importId}/segments/{segmentId}"
tags: ["v1"]
---

# Updates a segment by its public ID for an import

`PATCH /imports/{importId}/segments/{segmentId}`

Updates a segment for an import. The segment is identified by its globally unique public ID.

## Path parameters

- `importId` string, uuid, required
- `segmentId` string, uuid, required

## Request body

- SegmentUpdate
  - `name` string
  - `description` string
  - `cpm` number, double
  - `categories` string[]

## Response `200`

- Segment
  - `id` string, uuid, required
  - `code` string, required
  - `name` string, required
  - `importId` string, uuid, required
  - `description` string
  - `cpm` number, double
  - `categories` string[]
  - `updatedAt` string, date-time, required

## Other responses

- `400` — Invalid value for: path parameter importId, Invalid value for: path parameter segmentId, Invalid value for: body
- `default`

---

[API](https://skmtc.net/permutive/apis/custom-cohort-segmentation-api.md) · [All operations](https://skmtc.net/permutive/apis/custom-cohort-segmentation-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/permutive/custom-cohort-segmentation-api/revisions/9fb06b4e8a44/schema)