Delete User Account

From docs
Revision as of 09:25, 21 July 2026 by Ashley DeBon (talk | contribs) (Successful Response (200))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Mobile_API »Delete User Account

Base URL

https://apimobile.callproof.com

Endpoint

/api/delete-user

Purpose

Disables/deletes the authenticated user’s account. The account is marked as disabled (login turned off), an account-disabled setting is recorded, and a delete-account record is stored for the user and company.

HTTP Method

DELETE

Headers

Header Required Description
Authorization Yes Bearer access token

Security

  • Yes – Requires Bearer Token authentication.

Parameters

Path Parameters

None.

Query Parameters

None.

Request Body

None.

cURL Example for Android

 curl --location --request DELETE 'https://apimobile.callproof.com/api/delete-user' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' 

cURL Example for iOS

 curl --location --request DELETE 'https://apimobile.callproof.com/api/delete-user' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' 

Successful Response (200)

Indicates that the user account was deleted/disabled successfully.

Field Type Description
clientStatusCode integer Status indicator for the client (for example, 200)
user_id integer Identifier of the authenticated user
company_id integer Identifier of the authenticated user’s company
message string Confirmation message (for example, "User Account Deleted successfully")
uri string Requested resource URI

Error Responses

Status Code Meaning
400 Bad Request – the user account could not be deleted
401 Unauthorized – missing, invalid, or expired Bearer token
  • 400 – An error occurred while disabling the account (for example, "Your account is disabled. Please contact admin.").
  • 401 – Authentication failed or the access token is missing/expired.