---
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` SegmentGroupGraph
    - `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-09-23** `1816e2044c07` — 2 info
  - added the new optional request property `graph/nodes/additionalProperties/oneOf[subschema #1: ConditionNode]/expr/name`
  - added the new `function` enum value to the request property `graph/nodes/additionalProperties/oneOf[subschema #1: ConditionNode]/expr/tokens/items/type`
- **2026-09-18** `fb9750c99d0a` — 1 warning
  - for the `path` request parameter `segment_group_id`, the maxLength was set to `32`
- …earlier changes not shown

[Full 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.dev/aghanim/apis/aghanim-server-to-server-api/revisions/32e27bc547ae?raw)