Update Segment

Update Segment

PATCH https://api.ocamba.com/v1/hood/segments/{id}
Updates the specific Segment by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

Warning
The following targeting fragments are deprecated: remote_users, users, subscribed_age, user_data, tags, accounts. Instead use the following fragments which match the deprecated fragments, respectively: remote_ids, profiles, profile_age, custom_properties, containers, partners.

Rate limits:

  • Burst: 10/s
  • Steady: 150/m

Path parameters

parameters

Request schema

body

Response schemas

204
No Content
curl -X PATCH \
 "https://api.ocamba.com/v1/hood/segments/{id}" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "US 5+ days",
  "targeting": {
    "countries": {
      "op": "eq",
      "items": [
        "US"
      ]
    }
  }
}'
const url = 'https://api.ocamba.com/v1/hood/segments/{id}';
const options = {
  method: 'PATCH',
  headers: {
    Authorization: "Bearer {TOKEN}",
    'Content-Type': "application/json"
  },
  body: JSON.stringify(
    {
      "name": "US 5+ days",
      "targeting": {
        "countries": {
          "op": "eq",
          "items": [
            "US"
          ]
        }
      }
    }
  )
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
$ch = curl_init("https://api.ocamba.com/v1/hood/segments/{id}");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer {TOKEN}",
  "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(
  [
    "name" => "US 5+ days",
    "targeting" => [
      "countries" => [
        "op" => "eq",
        "items" => [
          "US"
        ]
      ]
    ]
  ]
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

Responses

204 No Content

400 Bad Request

{
  "code": 400,
  "title": "Bad request.",
  "message": "The request is not valid.",
  "trace_id": "99a84211-f73d-4ff8-acdf-eb3e06bb9d62"
}

500 Internal Server Error

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