Skip to main content
DELETE
/
v1
/
users
/
{user_id}
Delete a User
curl --request DELETE \
  --url https://api.example.com/v1/users/{user_id}/

​
Overview

This endpoint removes a user from the system. The operation permanently deletes the specified user record.

​
Request

​
Endpoint

DELETE https://prod.transcrypts.com/v1/users/{user_id}/

​
Authentication

API authentication requires the following headers:
HeaderDescription
X-Access-Client-IdYour Client ID
X-Access-SecretYour Access Key

​
Path Parameters

ParameterTypeRequiredDescription
user_idstringYesThe unique identifier of the user to be removed

​
Response

​
Success Response (HTTP 204)

A successful deletion returns an HTTP 204 No Content status, indicating the user has been removed.

​
Error Responses

Status CodeDescription
401Unauthorized - Missing or invalid authentication credentials
403Forbidden - Insufficient permissions
404Not Found - User does not exist

​
Example Error Response (401)

{
  "error": {
    "code": "authentication_failed",
    "message": "No such token"
  }
}

​
Example Error Response (403)

{
  "error": {
    "code": "not_authenticated",
    "message": "Authentication credentials were not provided."
  }
}