The segments field on access profiles, roles, and entitlements is patchable through their respective PATCH APIs (Patch Access Profile, Patch Role, Patch Entitlement).
To add a segment without overwriting existing assignments, /segments/- should work:
[
{
"op": "add",
"path": "/segments/-",
"value": "segment-id"
}
]
For removal, you can retrieve the current assignments with a GET on the access item (for example, GET /v2026/access-profiles/{id}), remove the unwanted segment ID from the array, and send the updated list back:
[
{
"op": "replace",
"path": "/segments",
"value": ["segment-id-1", "segment-id-2"]
}
]
If the item is made requestable before the segment assignment is completed, it may briefly be visible to everyone. Keeping it non-requestable until the segment PATCH succeeds should help avoid that gap.
The public Patch Segment endpoint updates segment properties such as name, description, owner, visibility criteria, and active status. It does not modify the access-item assignments. For a consistent approach across roles, access profiles, and entitlements, updating the segments field on the access item itself would be the way to go.
Segments only control Request Center visibility. They do not automatically assign or provision access to matching users.