Delete team

DELETE

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

Schedule a team for deletion (soft delete).

The team's status is set to pending_deletion and a hard deletion is scheduled 30 days from now.
During this grace period the team is retained for recovery purposes. All members are removed from the team,
and each member's teams array is updated accordingly. A member's billingAccount is cleared when no
other team of theirs shares it.

Preconditions

The team cannot be deleted when any of the following are true:

The team already has status = pending_deletion → 409 resource_conflict.

The team has existing invoices, payments, or receipts → 400 business_rule_violation.

The team has any active integration (completed = true) among:
stripe, mercadopago, paypal, openpay, conekta, clip, bank, shopify, whmcs, hilos
→ 400 business_rule_violation.

gigstack Connect: Delete other teams using the team parameter.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

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

Path Params

Query Params

Responses

🟢200OK

application/json

Team scheduled for deletion

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🟠409

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://api.gigstack.io/v2/teams/team_1234567890?team' \
--header 'Authorization: <api-key>'

Response Example

200 - Example 1

{
    "message": "Team scheduled for deletion",
    "data": {
        "id": "team_1234567890",
        "status": "pending_deletion",
        "scheduled_deletion": {
            "date": 1779984000000,
            "flagged_at": 1777392000000,
            "flagged_by": "user_abc123"
        }
    }
}

Modified at 2026-04-23 18:04:40

Sign manifest document

Users API Guide

Delete team

Preconditions#

Request

Responses

Preconditions