User Guides Developer Guides API Reference Changelog
⌘ K

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.

Rate limits:

Burst: 10/s
Steady: 150/m

Path parameters

parameters

Response schemas

DELETE https://api.ocamba.com/v1/hood/profiles/{id} HTTP/1.1
Host: api.ocamba.com
Authorization: Bearer YOUR_SECRET_TOKEN

curl -X DELETE "https://api.ocamba.com/v1/hood/profiles/{id}" \
  -H "Authorization: Bearer $TOKEN"

fetch("https://api.ocamba.com/v1/hood/profiles/{id}", {
  method: "DELETE",
  headers: { Authorization: `Bearer ${TOKEN}` }
}).then(r => r.json());

$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

HTTP/1.1 204 No Content
Content-Type: application/json

500 Internal Server Error

HTTP/1.1 500 Internal Server Error
Content-Type: application/json

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

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