Skip to main content
Profiles

Delete

Soft-delete a profile. Existing integrations bound to it keep their profileId.

Endpoint

DELETE https://api.postpeer.dev/v1/profiles/{id}

Path Parameters

ParameterTypeDescription
idstringProfile ID

What happens to bound integrations

Deleting a profile does not orphan its integrations. They keep their profileId field — the profile row just disappears from GET /v1/profiles and can no longer be referenced when creating new connections. To list integrations whose profile was deleted, query /v1/connect/integrations?profileId=null.

If you want to drop the integrations too, disconnect them first, then delete the profile.

Example

curl -X DELETE "https://api.postpeer.dev/v1/profiles/65ab123" \
  -H "x-access-key: YOUR_API_KEY"

Response

{
  "success": true,
  "message": "Profile deleted."
}

Status Codes

CodeMeaning
200Profile deleted
400Invalid profile id
404Profile not found

On this page