Profiles
Delete a profile
Deletes a profile and everything inside it. Disconnect its social accounts first so their tokens are revoked deliberately.
Required permission: `connections:write`
DELETE
/v1/profiles/{id}connections:writeRequest
Authorization
Send your API key as a Bearer token in the Authorization header.
Path parameters
idstringrequiredProfile id.
Response
Returns 200.
deletedbooleanrequiredidstringrequiredErrors
Failures use the standard error format.
| Status | Code | When it happens |
|---|---|---|
| 400 | invalid_request | The request body or query string failed validation. The message names the offending field. |
| 401 | invalid_api_key | The key does not exist, was revoked, or is malformed. Keys start with cdyn_live_. |
| 403 | profile_not_accessible | The requested profile is outside this key’s scope, or belongs to another account. |
| 409 | profile_has_connected_accounts | Disconnect the profile’s social accounts before deleting it, so tokens are revoked deliberately. |
| 429 | rate_limit_exceeded | Too many requests for this key. Honour the Retry-After header before retrying. |
| 500 | internal_error | Something failed on our side. Retry with the same Idempotency-Key; report the requestId if it persists. |