Stream file metadata
The same resolution as `/metadata/query`, delivered as newline-delimited JSON (`application/x-ndjson`) so a client can render the first records without waiting for the whole batch. One JSON object per line.
The same resolution as /metadata/query, delivered as newline-delimited
JSON (application/x-ndjson) so a client can render the first records
without waiting for the whole batch. One JSON object per line.
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
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/x-ndjson
application/json
application/json
application/json
curl -X POST "https://example.com/api/files/metadata/stream" \ -H "Content-Type: application/json" \ -d '{ "ids": [ "6e0346a3-e54d-40e3-9779-4ba1e707e35b" ] }'"string"Resolve file metadata in bulk POST
Resolves many file ids in one call. Ids the caller cannot read are omitted from the response rather than erroring, so a partial result is normal.
Upload files POST
Uploads one or more binary assets as `multipart/form-data` under the field name `files`. Images are stored, processed for width variants and given a BlurHash. This is the first half of a `media` import: upload the images here, then pass the returned ids as `file_ids` to `POST /api/imports`.