Upload a file

POST /rest/v1/files

Upload an image binary when it isn't publicly hosted anywhere. The returned url can be used in product images[]. Max 10 MB; JPEG/PNG/WebP.

Authorization

apiKey

AuthorizationBearer <token>

Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

base64*string

Base64-encoded image (max 10 MB).

Response Body

`application/json`

curl -X POST "https://example.com/files" \  -H "Content-Type: application/json" \  -d '{    "base64": "string"  }'

{  "id": "file_9dk2a",  "object": "file",  "url": "http://example.com"}

Last updated on July 28, 2026

Need help?

The API is in private beta — email us and a human replies, usually within one business day.

Email us API status

Authorization

Request Body

Response Body

201application/json

422application/json

`application/json`

`application/json`