Delete a profile

Delete a profile

DELETE https://api.ocamba.com/v1/hood/profiles/{id}
Deletes a profile from the system. This endpoint is idempotent, meaning repeated DELETE requests will not have any additional effect if the profile is already deleted.

Warning
This change will be automatically synchronized. Once a profile is deleted, they can no longer be engaged.
Note
We recommend you consider other options before deletion.
Tip
If you don’t know the profile id, list the profiles to find it.

Rate limits:

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

Path parameters

parameters

Response schemas

204
No Content
curl -X DELETE \
 "https://api.ocamba.com/v1/hood/profiles/{id}" \
  -H "Authorization: Bearer {TOKEN}"
const url = 'https://api.ocamba.com/v1/hood/profiles/{id}';
const options = {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer {TOKEN}`
  }
};

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/profiles/{id}");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "Authorization: Bearer {TOKEN}"
]);
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