---
title: "Update Segment Group"
method: PUT
path: "/v1/segment_groups/{segment_group_id}"
tags: ["Segmentation"]
---

# Update Segment Group

`PUT /v1/segment_groups/{segment_group_id}`

## Path parameters

- `segment_group_id` string, required

## Request body

- SegmentGroupUpdate
  - `name` string
  - `graph` GraphRoot
    - `id` string, required
    - `next_node_id` string
    - `title` string
    - `x` integer, required
    - `y` integer, required
    - `result` string
    - `model_type` string
    - `break_on_error` boolean
    - `description` string
    - `nodes` object
    - `view_port` ViewPort
      - `x` number, required
      - `y` number, required
      - `zoom` number, required
  - `type` 'static' | 'dynamic'
  - `enabled` boolean
  - `is_template` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-20** `8662e77bc1e2` — 2 info
  - added `BanUserNode, BatchBanUserNode, DeclinePaymentNode, Require3DSNode` discriminator mapping keys to the `graph/nodes/additionalProperties/` request property
  - added `#/components/schemas/BanUserNode, #/components/schemas/BatchBanUserNode, #/components/schemas/Require3DSNode, #/components/schemas/DeclinePaymentNode` to the `graph/nodes/additionalProperties/` request property `oneOf` list
- **2026-08-12** `a14f6ce6d187` — 81 warning, 2 info
  - the `graph/nodes/additionalProperties/oneOf[subschema #11: CreateItemBannerActionNode]/config/featured_item_id` request property's maxLength was set to `32`
  - the `graph/nodes/additionalProperties/oneOf[subschema #11: CreateItemBannerActionNode]/config/store_id` request property's maxLength was set to `32`
  - the `graph/nodes/additionalProperties/oneOf[subschema #11: CreateItemBannerActionNode]/config/store_item_id` request property's maxLength was set to `32`
  - the `graph/nodes/additionalProperties/oneOf[subschema #11: CreateItemBannerActionNode]/page_id` request property's maxLength was set to `32`
  - …79 more

[Change history](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/changes/v1/segment_groups/:segment_group_id/put.md)

---

[API](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api.md) · [All operations](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aghanim/aghanim-server-to-server-api/revisions/fbb6b66272c8/schema)