Skip to main content
DELETE
/
basins
/
{basin}
Delete Basin
curl --request DELETE \
  --url https://api.example.com/basins/{basin}

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/s2-streamstore/s2/llms.txt

Use this file to discover all available pages before exploring further.

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

Get started for freeTalk to us