Last updated on 8th May 2026

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 OK status
  • All team memberships and project assignments are permanently removed
  • This action cannot be undone