Delete a portfolio segment.
DELETE/segments/:segment_id
Permanently deletes a portfolio segment owned by the authenticated user. Listings matched by the segment's filter are not affected. Deleting the default segment leaves the user with no default segment.
A segment assigned to a team member cannot be deleted, because doing so would change which listings that team member can access. Remove it from the team member's assigned segments with POST /teams/members/{sub_user_id}/assigned_segments first.
Request
Responses
- 204
- 400
- 401
- 403
- 404
- 409
- 429
Segment deleted.
The segment is assigned to a team member. Unassign it first.
API key authorization failed.
Read-only API key cannot delete segments.
Segment not found or does not belong to the authenticated user.
A change to the account's team members is in progress. Retry after it completes.
Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the Rate Limits section in the overview for the recommended exponential backoff strategy.