---
title: "Update a segment by ID"
method: PUT
path: "/{globalCompanyId}/segments/{id}"
tags: ["Segments"]
---

# Update a segment by ID

`PUT /{globalCompanyId}/segments/{id}`

## Path parameters

- `globalCompanyId` string, required
- `id` string, required

## Query parameters

- `locale` string
- `expansion` string[]

## Headers

- `Authorization` string, required
- `x-api-key` string, required

## Request body

- object

## Response `200`

successful operation

- AnalyticsSegmentResponseItem
  - `id` string — Id of the segment.
  - `name` string — A name for the segment.
  - `description` string — A description of the segment.
  - `rsid` string — The report suite id.
  - `reportSuiteName` string — The friendly name for the report suite id.
  - `owner` Owner
    - `id` integer, required — the login id of the owner
    - `name` string — the friendly full login name of the owner, included when the expansion parameter ownerFullName is true
    - `login` string — the friendly full login name of the owner, included when the expansion parameter ownerFullName is true
  - `definition` AnalyticsSegmentDefinition
    - `container` object
      - `context` string
      - `func` string
      - `pred` object
        - `val` object
          - `description` string
          - `name` string
          - `func` string
        - `str` string
        - `func` string
    - `func` string
    - `version` integer[]
  - `compatibility` SegmentCompatibility
    - `valid` boolean
    - `message` string
    - `validator_version` string
    - `supported_products` string[]
    - `supported_schema` string[]
    - `supported_features` string[]
  - `definitionLastModified` string, date-time
  - `categories` string[]
  - `siteTitle` string — A name for the report suite. This is deprecated and should use the report suite name instead.
  - `tags` Tag[] — All existing tags associated with the segment.
    - `id` integer — the tag id
    - `name` string — the tag name
    - `description` string — the tag description
    - `components` TaggedComponent[] — the list of components that have been tagged with this tag
      - `componentType` string
      - `componentId` string
      - `tags` string[]
  - `modified` string, date-time
  - `created` string, date-time

## Other responses

- `400` — Definition must be formatted as a JSON Object
- `401` — Company mismatch; segment ownership can only be transferred within the same organization
- `403` — User does not have permission to update this segment
- `500` — External API error; Segment update or retrieval failed

## Changes

- **2025-08-07** `f13c80692287` — 1 warning
  - deleted the `header` request parameter `x-gw-ims-org-id`
- **2025-08-06** `f49e893a6c2b` — 1 breaking
  - added the new required `header` request parameter `x-gw-ims-org-id`
- **2022-05-10** `dcd4514630c4` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/adobe/apis/adobe-analytics-apis/changes/:globalCompanyId/segments/:id/put.md)

---

[API](https://skmtc.dev/adobe/apis/adobe-analytics-apis.md) · [All operations](https://skmtc.dev/adobe/apis/adobe-analytics-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adobe/adobe-analytics-apis/revisions/b2e01ce0f30a/schema)