List segment members
Returns one page of the member list of a segment, oldest first, and the total number of matching members. Use limit and offset to page through the list.
Requires a management key.
Returns 404 if no segment has this key.
bearerAuthorizationBearer <token>Send a credential in the Authorization header: Authorization: Bearer <token>.
Each credential belongs to one environment of one workspace, so the API never takes a workspace or environment in the URL.
- Management key (
ffk_…, secret): manages flags, segments, environments, and API keys, and reads the audit log and analytics. It can also do everything an evaluation key can. - Evaluation key (
ffk_…, secret): for server SDKs. It evaluates flags, reads flag definitions for local evaluation, and sends telemetry. - Public token (
ffp_…, not secret): for browser and mobile apps. It evaluates flags through OFREP and sends telemetry. It cannot read flag definitions.
Keep secret keys on your server. A 401 response means the credential is missing or not valid. A 403 response means the credential is valid but its role cannot perform the operation.
key*stringThe segment key, such as beta-testers.
query?stringReturn only members whose key contains this text. The match ignores case.
limit?stringThe maximum number of members to return, as a whole number. Defaults to 50. Values above 200 return 200 members.
offset?stringThe number of members to skip, as a whole number. Defaults to 0.
OK
application/json- response
One page of a segment's member list.
members*array<>The members on this page, oldest first.
total*number|curl -X GET 'https://api.toggld.io/api/v1/segments/string/members'{ "members": [ { "key": "user-123", "addedAt": "2026-05-02T10:00:00.000Z" }, { "key": "user-456", "addedAt": "2026-05-02T10:00:00.000Z" } ], "total": 2}Delete a segment DELETE
Permanently deletes a segment and its member list. Requires a management key. Returns `404` if no segment has this key. Returns `409` while targeting rules still use the segment. The response lists those flags in `flagKeys`.
Update segment members POST
Adds and removes member keys in one request, and returns the updated segment. Adding an existing member or removing a missing one has no effect, so you can safely retry. Use this endpoint to import members in bulk. Requires a management key. Returns `404` if no segment has this key and `422` if the segment would have more than 5,000 members.