Create a basin.
curl --request POST \
--url https://a.s2.dev/v1/basins \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"basin": "<string>"
}
'{
"created_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"deleted_at": "2023-11-07T05:31:56Z",
"location": "<string>"
}{
"created_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"deleted_at": "2023-11-07T05:31:56Z",
"location": "<string>"
}{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}basins
Create a basin.
Create a new S2 basin with a name, location, and optional configuration.
POST
/
basins
Create a basin.
curl --request POST \
--url https://a.s2.dev/v1/basins \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"basin": "<string>"
}
'{
"created_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"deleted_at": "2023-11-07T05:31:56Z",
"location": "<string>"
}{
"created_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"deleted_at": "2023-11-07T05:31:56Z",
"location": "<string>"
}{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your access token.
Headers
Client-specified request token for idempotent retries.
Maximum string length:
36Body
application/json
Basin name which must be globally unique. It can be between 8 and 48 bytes in length, and comprise lowercase letters, numbers and hyphens. It cannot begin or end with a hyphen.
Required string length:
8 - 48Basin configuration.
Show child attributes
Show child attributes
Basin location. If omitted when creating, uses the default location for the account.
Required string length:
1 - 64
