Skip to main content
DELETE
/
basins
/
{basin}
Delete Basin
curl --request DELETE \
  --url https://api.example.com/basins/{basin}
Delete a basin. The deletion is asynchronous and the basin will enter the deleting state.

Path Parameters

basin
string
required
Basin name.

Response

Returns 202 Accepted status code with no body on successful deletion request. The basin enters the deleting state and will be removed once all contained streams are deleted.

Example

curl -X DELETE "https://aws.s2.dev/v1/basins/my-basin" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response (202 Accepted)

HTTP/1.1 202 Accepted

Error Responses

  • 404 Not Found - Basin does not exist
  • 400 Bad Request - Invalid basin name
  • 403 Forbidden - Insufficient permissions
  • 408 Request Timeout - Request timed out

Build docs developers (and LLMs) love