Delete a segment
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.
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.
No content
curl -X DELETE 'https://api.toggld.io/api/v1/segments/string'Update a segment PATCH
Changes the name, description, key attribute, or rules of a segment. Omitted fields keep their current values. The change applies to every flag that uses the segment, in every environment. Requires a management key. Returns `404` if no segment has this key, `409` if `expectedVersion` does not match the current version, and `422` if the rules are not valid.
List segment members GET
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.