Update Tag

Update Tag

PATCH https://api.ocamba.com/v1/hood/tags/{id}
Updates the specific Tag 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/tags/{id}" \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '"{\n  \"name\": \"Demo Tag\",\n  \"status\": \"active\",\n  \"apps\": {\n    \"web\": [\n      \"ocamba.com\"\n    ],\n    \"android\": [\n      \"com.Ocamba.demo\"\n    ],\n    \"ios\": [\n      \"com.ocamba.iosdemo\"\n    ]\n  },\n  \"settings\": {\n    \"general\": {\n      \"include_subdomains\": true,\n      \"analytics\": true,\n      \"crashlytics\": true,\n      \"push\": true,\n      \"consent\": true\n    }\n  },\n  \"description\": \"This is my first tag.\",\n}"'
const url = 'https://api.ocamba.com/v1/hood/tags/{id}';
const options = {
  method: 'PATCH',
  headers: {
    Authorization: "Bearer {TOKEN}",
    'Content-Type': "application/json"
  },
  body: JSON.stringify(
    "{\n  \"name\": \"Demo Tag\",\n  \"status\": \"active\",\n  \"apps\": {\n    \"web\": [\n      \"ocamba.com\"\n    ],\n    \"android\": [\n      \"com.Ocamba.demo\"\n    ],\n    \"ios\": [\n      \"com.ocamba.iosdemo\"\n    ]\n  },\n  \"settings\": {\n    \"general\": {\n      \"include_subdomains\": true,\n      \"analytics\": true,\n      \"crashlytics\": true,\n      \"push\": true,\n      \"consent\": true\n    }\n  },\n  \"description\": \"This is my first tag.\",\n}"
  )
};

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/tags/{id}");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer {TOKEN}",
  "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(
  "[\n  \"name\" => \"Demo Tag\",\n  \"status\" => \"active\",\n  \"apps\" => [\n    \"web\" => [\n      \"ocamba.com\"\n    ],\n    \"android\" => [\n      \"com.Ocamba.demo\"\n    ],\n    \"ios\" => [\n      \"com.ocamba.iosdemo\"\n    ]\n  ],\n  \"settings\" => [\n    \"general\" => [\n      \"include_subdomains\" => true,\n      \"analytics\" => true,\n      \"crashlytics\" => true,\n      \"push\" => true,\n      \"consent\" => true\n    ]\n  ],\n  \"description\" => \"This is my first tag.\",\n]"
));
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
At least one of the updatable fields should be sent via HTTP body in order to change the current state of the bid modifier. Web app names are sanitized to be all lowercase. Android and iOS app names stay the same.
Tip
If you don’t know the Tag ‘id’, list the Tags to find it.