Agent-readable docs index: /docs/llms.txt. Full docs in one file: /docs/llms-full.txt. Download /docs/docs.zip to grep all markdown files locally.

Delete contact

/contacts/{id}DELETE
Permanently removes the contact identified by ID from the API key's organisation. The successful response has no body. Use opt-out preferences instead when the contact and historical activity should be retained.
Authorization
BearerAuth *Bearer <token>
API key generated under Account Settings → API Keys (rk_live_...). Send as header Authorization: Bearer <key>.
Response
204 · Contact deleted successfully (no content returned)
Contact deleted successfully (no content returned)
401 · Unauthorized
success *boolean
Example: false
error *string
Human-readable error message explaining the failure reason.
Example: "Recipient not reachable on WhatsApp."
error_code *string
Stable machine-readable error code.
Example: "recipient_not_on_whatsapp"
404 · Resource not found
success *boolean
Example: false
error *string
Human-readable error message explaining the failure reason.
Example: "Recipient not reachable on WhatsApp."
error_code *string
Stable machine-readable error code.
Example: "recipient_not_on_whatsapp"
Request example
curl -X DELETE "https://convert.ruut.chat/api/v1/contacts/1042" \
  -H "Authorization: Bearer <token>"
Response example
{
  "success": false,
  "error": "Invalid, expired, or revoked API key.",
  "error_code": "unauthorized"
}