REST API

The complete, always-current endpoint reference lives at /api — every endpoint with request bodies, response schemas and status codes, generated from the API's own OpenAPI spec.

The essentials

Base URL — https://api.filedgr.network (also api.test. and api.dev.).

Auth — every request carries x-api-key and x-api-secret. There are no anonymous endpoints and no bearer tokens. The key is the principal: path segments naming a user always resolve to the key holder.

Server-to-server only — those two headers are not in the CORS allowlist, so browser calls fail preflight.

Shapes — request and response fields are snake_case. Lists come back as {total_records, current_page, total_pages, content}, and an empty list is 204 with no body.

Read these first

• Conventions — pagination, the 204-on-empty rule, the error envelope, ledger values
• Credits & Billing — what creation costs and who pays
• Quick Start — a working end-to-end integration