Get a file
Returns the asset for a file the caller can read — their own, or one shared through a household. Prefer the CDN `url` from the file's metadata for anything user-facing; it is cached at the edge.
Returns the asset for a file the caller can read — their own, or one
shared through a household. Prefer the CDN url from the file's
metadata for anything user-facing; it is cached at the edge.
Authorization
bearerAuth A Clerk session JWT. Obtain one with a Clerk frontend SDK
(session.getToken()) or, for server-to-server use, with a Clerk
machine token. The token's sub claim is the Flambe user id that scopes
every request.
In: header
Path Parameters
uuidResponse Body
application/octet-stream
application/json
application/json
application/json
curl -X GET "https://example.com/api/files/497f6eca-6276-4993-bfeb-53cbbbba6f08""string"Subscribe to live events GET
A [Server-Sent Events](https://developer.mozilla.org/docs/Web/API/Server-sent_events) stream of changes to the caller's data — most usefully, import progress and completion, which removes the need to poll `GET /api/imports/{id}`. The connection is authenticated with the usual `Authorization: Bearer` header. Note that the browser's built-in `EventSource` cannot set headers, so on the web you need a fetch-based SSE client. The server sends a comment line every few seconds as a keep-alive; ignore lines beginning with `:`.
Get file metadata GET
Next Page