Delete user

DELETE

https://api.gigstack.io/v2/users/{id}

Permanently delete a user.

The handler removes the user from membersIds/members of every team they belong to,
deletes the Firestore users/{id} document, and then deletes the Firebase Auth account
(best-effort — an Auth deletion failure is logged but does not fail the request).

You cannot delete yourself. If the id matches the user behind the API key the call
is rejected with 400 / business_rule_violation.

gigstack Connect: Delete other teams' users using the team parameter.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

Query Params

Responses

🟢200OK

application/json

User deleted successfully.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://api.gigstack.io/v2/users/user_1234567890?team=undefined' \
--header 'Authorization: <api-key>'

Response Example

200 - Success Example

{
    "success": true,
    "message": "User deleted successfully",
    "timestamp": 1767225600000,
    "data": {
        "id": "user_1234567890",
        "deleted": true
    }
}

Modified at 2026-08-05 21:48:25

Generate login link

Reset user password