Skip to main content
POST
/
buckets
cURL
curl --request POST \
  --url https://api.nightly.sh/v1/buckets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>"
}
'
{
  "id": "nly_test_buc_1amaj5125as",
  "name": "Acme Corporation Bucket",
  "host": "1amaj5125as.sftp.nightly.sh",
  "active": true,
  "created_at": 692233200
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Bucket to create

​
name
string
required

The human-readable name for the bucket.

Response

Bucket response

​
id
string
required

Unique identifier for the bucket.

​
host
string
required

The host for the bucket. This can be provided to your customers for SFTP connectivity.

​
name
string
required

The human-readable name for the bucket.

​
active
boolean
required

Whether or not the bucket is active and accepting connections/files.

​
created_at
integer
required

Unix Timestamp of when the bucket was created.