Delete Team via API
This method allows you to delete a team. All team memberships and project assignments will be removed.
Tip: You can explore and test this endpoint interactively using our OpenAPI documentation.
URL
/teams/:identifier
HTTP Method
DELETE
Supported Parameters
| Parameter | Type | Description |
|---|---|---|
identifier |
String | The team identifier (in the URL) |
Example cURL Request
curl -X DELETE \
-H "Content-type: application/json" \
-H "Accept: application/json" \
--user adam@atechmedia.com:my-api-key \
https://test.deployhq.com/teams/abc123-def456
Example Response
{
"status": "deleted"
}
Notes
- Returns a confirmation with
200 OKstatus - All team memberships and project assignments are permanently removed
- This action cannot be undone