Build with Nomia Storage

Full programmatic control over files, workspaces, permissions, and audit logs. Get from zero to first upload in under ten minutes.

https://api.nomiastorage.com/v1 Base URL

Getting started

All paths share the same REST API. Pick the one that fits your workflow.

REST API quickstart

Authenticate, upload a file, and get a download link in five curl commands.

Install the Nomia CLI with a single command and sync folders from your terminal.

Subscribe to upload, delete, and share events over HTTPS with a signed payload.

S3-compatible API

Migrate S3-compatible workloads without changing a single line of application code.

Official SDK libraries

Thin wrappers around the REST API. All SDKs are open source (MIT).

Node.js Python Go Ruby

API reference overview

Authenticate via Authorization: Bearer <token>. Tokens are scoped to a workspace and revocable at any time from account settings.

GET/filesList files in a folder

POST/files/uploadUpload a file

GET/files/:id/downloadGet a signed download URL

DEL/files/:idDelete a file

POST/sharesCreate a share link

GET/workspacesList workspaces

GET/audit/eventsExport audit log

Full API reference →

UPLOAD EXAMPLE

          curl -X POST \

            "https://api.nomiastorage.com/v1/files/upload" \

            -H "Authorization: Bearer $TOKEN" \

            -F "file=@report.pdf" \

            -F "folder_id=fld_3k9xpt"

          # 201 Created

          { "id": "fil_8r4nqz",

            "name": "report.pdf",

            "size_bytes": 2048374 }