Skip to main content
DELETE
/
v1
/
teams
/
{id}
cURL
curl --request DELETE \
  --url http://sandbox.mintlify.com/v1/teams/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": null
}
Delete a team by its ID. You can only delete teams where you are the owner.
This action is permanent and cannot be undone. Deleting a team may affect all team members, event types, and scheduled events associated with the team.

​
Path Parameters

​
id
integer
required
The unique identifier of the team to delete.

​
Response

​
success
boolean
required
Indicates whether the request was successful. Always true for successful responses.
​
data
null
Always null for successful delete operations.

​
Example Response

{
  "success": true,
  "data": null
}

​
Error Response

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Team not found."
  }
}

{
  "success": false,
  "error": {
    "code": "ACCESS_DENIED",
    "message": "You are not authorized to delete this team."
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
integer<int64>
required

ID of team to delete

Response

Team deleted

​
success
boolean
required

Indicates whether the request was successful

Example:

true

​
data
object
required

The response data. Can be an object, array, or null