Remove Segments from a Segment List

POST /segment-lists/{id}/remove-segments
Copied
Arrow
                https://api.ocamba.com/v1/hood/segment-lists/{id}/remove-segments

Removes up to 100 Segments from the specified Segment List. Unknown Segments will be ignored.

Rate limits:

Burst: 10/s
Steady: 150/m

path Parameters
Arrow
Name
Description
idstringrequired
Unique resource identifier.


Example: 12345

Request Body Schema
Arrow
Name
Description
items[ string ]
A list of up to 100 unique Segment ids to be removed. If the operation would cause the total number of items in the Segment List to fall below the allowed minimum, the request will be rejected.
Response status codes
Arrow
204 - No Content
Arrow
400 - Bad Request
Arrow
Name
Description
codeinteger
Http response status code.


Example: 400
messagestring
The human readable message that describes how to deal with error.


Example: The request body is not valid.
titlestring
The error title.


Example: Bad request.
trace_idstring
Error trace id.


Example: 99a84211-f73d-4ff8-acdf-eb3e06bb9d62
500 - Internal Server Error
Arrow
Name
Description
codeinteger
Http response status code.


Example: 500
titlestring
The error title.


Example: Internal server error.
trace_idstring
Error trace id.


Example: 99a84211-f73d-4ff8-acdf-eb3e06bb9d62
Request examples
Copied
Arrow
request Arrow
  • request
{
  "items" : ["10000", "10001", "10002"]
}
Response examples
Copied
Arrow
400 Arrow
  • 400
  • 500
{
  "code": 400,
  "title": "Bad request.",
  "message": "The request body is not valid.",
  "trace_id": "99a84211-f73d-4ff8-acdf-eb3e06bb9d62"
}

{
  "code": 500,
  "title": "Internal server error.",
  "trace_id": "99a84211-f73d-4ff8-acdf-eb3e06bb9d62"
}