Teams: Delete

Straightforward guide for developers on how to delete an existing team using the API, including the necessary headers and the expected behavior of the response.

Endpoint

DELETE /api/teams/{team_id}

Delete an existing team by its unique identifier.

Request

HTTP Request

DELETE https://uptimekeep.com/api/teams/{team_id}

Replace {team_id} with the ID of the team you wish to delete.

Headers

Header	Type	Description
Authorization	String	Bearer token for API authentication.

Example of a request:

curl --request DELETE \
--url 'https://uptimekeep.com/api/teams/{team_id}' \
--header 'Authorization: Bearer {api_key}'

Response

A successful request will result in the deletion of the specified team. Typically, a 204 No Content status code is returned, indicating that the operation was successful and no content is returned in the response body.

Errors

If the request fails, the API will return an error message with an appropriate HTTP status code, such as 404 Not Found if the team ID does not exist.

---