Skip to main content
POST
Connect a bucket with your own key: test it, then seal it and create a read-only connection
No plan can call this operation today. It needs a personal access token, and Nitsor does not issue personal access tokens.

Authorizations

Authorization
string
header
required

An Agent credential (nits_…), or a person token (nitp_…) on a deployment that enables them. GET /api/v1/session names the principal a credential proves.

Body

application/json
bucket
string
required
Required string length: 1 - 63
credentials
object
required

The key pair, sent once. The server tests it against the bucket, and only when the read-only check passes stores it sealed. No response, event, log or error returns it.

idempotencyKey
string
required
Required string length: 1 - 200
name
string
required
Required string length: 1 - 200
pathStyle
boolean
required
prefix
string
required
Maximum string length: 1024
region
string
required
Required string length: 1 - 64
endpoint
string
Maximum string length: 2048
provider
object

Response

Connect a bucket with your own key: test it, then seal it and create a read-only connection

capabilities
object
required
connection
object
required
status
string
required
Allowed value: "connected"