files

Reserve an upload

For documents you would rather not send inline: returns a file_id and a presigned upload_url. PUT the bytes there with the given headers, then pass source.file_id to /v1/edit. Uploads expire with the retention window.

post/v1/files

Request

  • Base URL: https://api.niubai.vip (the document declares no server; this is the origin it was published from)
  • URL: https://api.niubai.vip/v1/files
  • Auth: HTTP bearer

Response

Successful Response

file_idstring required

Pass as source.file_id once the bytes are uploaded.

upload_urlstring required

PUT the document here.

headersobject

Headers the PUT must carry.

expires_atstring nullable

ISO 8601; the upload slot and the file expire then.

Changes

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