Skip to main content
DELETE
/
api
/
profiles
/
{id}
Delete Profile
curl --request DELETE \
  --url https://api.example.com/api/profiles/{id}
{
  "message": "<string>"
}
Permanently delete a profile.

​
Authentication

This endpoint requires Bearer token authentication. Include the JWT token in the Authorization header. 
Authorization: Bearer <your_token>

​
Path Parameters

​
id
string
required
Profile unique identifier (UUID format)Validation:
  • Must be a valid UUID
  • Profile must belong to the authenticated user

​
Response

Returns a success message upon successful deletion.
​
message
string
required
Success message confirming deletion

​
Example Request

curl -X DELETE https://api.contafy.com/api/profiles/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json"

​
Example Response

{
  "message": "Perfil eliminado exitosamente"
}

​
Error Responses

​
400 Bad Request
Invalid UUID format
{
  "errors": [
    {
      "field": "id",
      "message": "ID de perfil inválido"
    }
  ]
}
​
401 Unauthorized
User is not authenticated or token is invalid
{
  "error": "Usuario no autenticado"
}
​
404 Not Found
Profile not found or does not belong to authenticated user
{
  "error": "Perfil no encontrado"
}
​
500 Internal Server Error
Server error occurred while deleting profile
{
  "error": "Error al eliminar perfil"
}

​
Important Notes

  • This operation is permanent and cannot be undone
  • All associated data with the profile will be deleted
  • Users can only delete profiles that belong to them
  • After deletion, the RFC associated with this profile becomes available for use again
  • Any plugins or integrations associated with this profile will also be affected

​
Security

For security reasons, attempting to delete another user’s profile will return a 404 error (not 403) to prevent profile ID enumeration.

Build docs developers (and LLMs) love

Get started for freeTalk to us