OpenAPI spec
Every published API project automatically exposes a valid OpenAPI 3.0 document at /openapi.json on its base URL, no setup needed. It lists every enabled endpoint's path, method, and (for a key-protected endpoint) that it needs a bearer token, plus a real request-body schema and example responses built from your Validate and Response blocks. Import that URL directly into Postman, Insomnia, or any OpenAPI-based client generator.
Accepting a file upload
Send a request with Content-Type: multipart/form-data and any file fields are uploaded automatically before your endpoint's logic runs, the field's value becomes that file's public URL, usable anywhere downstream (a Database Query, a Response body) exactly like any other field.
Returning a file instead of JSON
A Response or Error Response block's type can be set to Serve file directly (fetches a URL you give it and returns its actual bytes, capped at 4MB) or Redirect (sends the caller straight to a file's own public URL instead, with no size limit, since your endpoint isn't the one serving the bytes). Redirect is the better choice for anything that might exceed 4MB.