Segments
Delete a segment
DELETE
/segments/{id}Needscontent.editRefused with segment_in_use (and the usage list) while content or other segments reference it, because that content would stop showing to anyone it targets. force=true deletes anyway.
Authorization
secretKeyheader
AuthorizationBearer <sk_…>A secret API key from Settings → API keys. It acts with its creator's role.
Path Parameters
id*integerThe segment's id.
Range
1 <= valueQuery Parameters
force?booleanDelete even if it's in use.
Response Body
OK
application/json- response
success*unknownShell
curl -X DELETE 'https://app.cueston.com/api/segments/1'Example Response
JSON
{
"success": true
}Update a segmentPATCH
Changes apply to drafts right away. Live content keeps the segment as it was when it was published, until you publish it again (its draft shows unpublished changes meanwhile).
Estimate a segment's sizeGET
Identified users active in the last 30 days who match, best effort. Trait rules can't be checked (traits aren't stored), so `upperBound` is true when there are any. 30 estimates a minute per workspace.