Object storage

S3 buckets and access keys.

Base https://api.nodion.com. Short paths need X-Nodion-Project unless the path already has /v2/projects/{id}. Request bodies are in the interactive docs.

GET /v2/buckets

List buckets in the current project

Scope read Interactive docs

POST /v2/buckets

Create a bucket in the current project

Scope write Interactive docs

GET /v2/projects/{id}/object_storage/usage

Object storage usage and cost for a project

Scope read Interactive docs

POST /v2/buckets/{id}/objects/share

Create a temporary share URL for a bucket object

Scope write Interactive docs

PUT /v2/buckets/{id}/public_read

Enable or disable public_read on a bucket

Scope write Interactive docs

GET /v2/buckets/{id}

Get a bucket

Returns the enriched bucket view used by the Show page (endpoint, usage, attachments, status).

Scope read Interactive docs

GET /v2/buckets/{id}/objects

List objects in a bucket

Scope read Interactive docs

POST /v2/buckets/{id}/objects

Upload objects into a bucket

Scope write Interactive docs

DELETE /v2/buckets/{id}/objects

Delete objects in a bucket

Requires the admin project role. Deletes up to 100 keys via the bucket service credentials.

Scope write Interactive docs

POST /v2/buckets/{id}/folders

Create a folder in a bucket

Scope write Interactive docs

DELETE /v2/buckets/{id}/folders

Delete a folder and its contents

Scope write Interactive docs

GET /v2/buckets/{id}/objects/content

Download one object from a bucket

Scope read Interactive docs

POST /v2/buckets/{id}/retry

Retry provisioning a pending or failed bucket

Requires the admin project role. Re-runs Skadi bucket and service-key provisioning.

Scope write Interactive docs

POST /v2/buckets/{id}/rotate_credentials

Rotate a bucket's service key

Scope write Interactive docs

POST /v2/buckets/{id}/attachments

Attach a bucket to an application

Scope write Interactive docs

PATCH /v2/bucket_attachments/{id}

Update a bucket attachment's bindings

Scope write Interactive docs

DELETE /v2/bucket_attachments/{id}

Detach a bucket from an application

Scope write Interactive docs

GET /v2/applications/{id}/bucket_attachments

List an application's bucket attachments

Scope read Interactive docs

GET /v2/storage_keys

List S3 access keys in the current project

Scope read Interactive docs

POST /v2/storage_keys

Create an S3 access key in the current project

Scope write Interactive docs

GET /v2/projects/{id}/storage_keys

List S3 access keys

Scope read Interactive docs

POST /v2/projects/{id}/storage_keys

Create an S3 access key

Scope write Interactive docs

PATCH /v2/storage_keys/{id}

Update an S3 access key policy

Scope write Interactive docs

DELETE /v2/storage_keys/{id}

Delete an S3 access key

Scope write Interactive docs

Give your agent a cloud.

Earn up to 15 € in credit when signing up.

Continue with GitHub

or with email