---
title: "Manage access to a specific segment"
method: POST
path: "/v1/segments/{id}:manage-access"
tags: ["segment"]
---

# Manage access to a specific segment

`POST /v1/segments/{id}:manage-access`

This endpoint updates access permissions for a specific segment by managing allowed team IDs.

## Path parameters

- `id` string, required

## Request body

- SegmentServiceManageAccessBody
  - `accessTeamIds` string[] — The list of team ids for which the segment is accessible

## Response `200`

Access updated.

- V1ManageAccessResponse — Empty response body.

## Other responses

- `400` — There was a problem with input.
- `401` — Login failed or token not valid.
- `403` — Login failed or token not valid.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/citrusad/apis/citrus-auth-api.md) · [All operations](https://skmtc.net/citrusad/apis/citrus-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrusad/citrus-auth-api/revisions/a040003c7378/schema)