---
title: "Update user context targets on a big segment"
method: POST
path: "/api/v2/segments/{projectKey}/{environmentKey}/{segmentKey}/users"
tags: ["Segments"]
---

# Update user context targets on a big segment

`POST /api/v2/segments/{projectKey}/{environmentKey}/{segmentKey}/users`

Update user context targets included or excluded in a big segment. Big segments include larger list-based segments and synced segments. This operation does not support standard segments.

## Path parameters

- `projectKey` string, string, required — The project key
- `environmentKey` string, string, required — The environment key
- `segmentKey` string, string, required — The segment key

## Request body

- SegmentUserState
  - `included` SegmentUserList
    - `add` string[]
    - `remove` string[]
  - `excluded` SegmentUserList
    - `add` string[]
    - `remove` string[]

## Response `204`

Action succeeded

## Other responses

- `400` — Invalid request
- `401` — Invalid access token
- `404` — Invalid resource identifier
- `429` — Rate limited

---

[API](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api.md) · [All operations](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/launchdarkly/launchdarkly-rest-api/revisions/69c5c9aafe78/schema)