Difference between revisions of "Delete User Account"

From docs
Jump to: navigation, search
(Created page with "== Delete User Account == === Base URL === https://apimobile.callproof.com === Endpoint === /api/delete-user === Purpose === Disables/deletes the authenticated user’s acc...")
 
(Successful Response (200))
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
== Delete User Account ==
+
== [[Mobile_API]] »Delete User Account ==
  
 
=== Base URL ===
 
=== Base URL ===
Line 33: Line 33:
 
==== Request Body ====
 
==== Request Body ====
 
None.
 
None.
 +
 +
=== cURL Example for Android ===
 +
 +
<pre> curl --location --request DELETE 'https://apimobile.callproof.com/api/delete-user' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' </pre>
 +
 +
=== cURL Example for iOS ===
 +
 +
<pre> curl --location --request DELETE 'https://apimobile.callproof.com/api/delete-user' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' </pre>
  
 
=== Successful Response (200) ===
 
=== Successful Response (200) ===

Latest revision as of 09:25, 21 July 2026

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.