Add segments to a Segment List

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

Adds up to 100 existing segments to the specified Segment List. Duplicate Segment ids are not allowed.

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 added. If the operation would cause the total number of items in the Segment List to exceed the allowed maximum, 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"
}