Update Deal

Update Deal

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

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/deals/{id}" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Example",
  "description": "Description example",
  "status": "inactive"
}'
const url = 'https://api.ocamba.com/v1/hood/deals/{id}';
const options = {
  method: 'PATCH',
  headers: {
    Authorization: "Bearer {TOKEN}",
    'Content-Type': "application/json"
  },
  body: JSON.stringify(
    {
      "name": "Example",
      "description": "Description example",
      "status": "inactive"
    }
  )
};

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/deals/{id}");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer {TOKEN}",
  "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(
  [
    "name" => "Example",
    "description" => "Description example",
    "status" => "inactive"
  ]
));
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 body 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

Note
Updatable fields are name, description, status, frequency_cap, clickthrough, time_window, country_price, device_price, event_price, base_price, budget, unique_conversion, performance_conditions, base_price_priority.
Warning
This change will be automatically synchronized to an ad server. Updating a deals status to inactive, also changes the status of all campaigns it is assigned to to inactive.
Tip
If you don’t know the deal id, list the deals to find it.