Skip to main content
GET
/
basins
/
{basin}
Get Basin Config
curl --request GET \
  --url https://api.example.com/basins/{basin}
{
  "default_stream_config": {
    "storage_class": "<string>",
    "retention_policy": {},
    "timestamping": {
      "mode": "<string>",
      "uncapped": true
    },
    "delete_on_empty": {
      "min_age_secs": 123
    }
  },
  "create_stream_on_append": true,
  "create_stream_on_read": true
}
Get the configuration for a basin.

Path Parameters

basin
string
required
Basin name.

Response

default_stream_config
object
Default stream configuration.
create_stream_on_append
boolean
Create stream on append if it doesn’t exist.
create_stream_on_read
boolean
Create stream on read if it doesn’t exist.

Example

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

Response

{
  "default_stream_config": {
    "storage_class": "standard",
    "retention_policy": {"age": 604800},
    "timestamping": {
      "mode": "client-prefer",
      "uncapped": false
    },
    "delete_on_empty": {
      "min_age_secs": 0
    }
  },
  "create_stream_on_append": true,
  "create_stream_on_read": false
}

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