Uploads

Initialise an upload — validate, allocate a Site, return presigned PUT URLs

post/uploads/init

Request

  • Base URL: https://api.nippy.host
  • URL: https://api.nippy.host/uploads/init
  • Auth: none declared

Request body

emailstring email required

Email address of the uploader. A magic-link sign-in is mailed on finalize.

subdomainstring required

Requested subdomain (server may disambiguate with -N suffix on collision)

refstring

First-touch acquisition channel (e.g. "cli", "mcp", "extension", a launch slug). Recorded on the user only if this upload creates the account; ignored for existing users.

Example request

{
  "email": "user@example.com",
  "subdomain": "my-site",
  "files": [
    {
      "name": "index.html",
      "size": 4827,
      "contentType": "text/html"
    }
  ],
  "ref": "mcp"
}

Response

Init successful — files should be PUT to the returned URLs

uploadBatchIdstring required
subdomainstring required

Subdomain the file will be served from. May differ from the requested value if disambiguation was applied.

expiresAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.