Flambe docs
API referenceImports

Report a bad import

Flag a completed import whose extraction was wrong. Reports feed triage of the extraction pipeline. One report per import per user.

POST
/api/imports/{id}/report

Flag a completed import whose extraction was wrong. Reports feed triage of the extraction pipeline. One report per import per user.

Authorization

bearerAuth
AuthorizationBearer <token>

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

id*string

Import identifier.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/imports/497f6eca-6276-4993-bfeb-53cbbbba6f08/report" \  -H "Content-Type: application/json" \  -d '{}'
{  "report_id": "5ed7905a-4735-4cf7-b1ab-521e066fb971",  "created_at": "2019-08-24T14:15:22Z"}

List imports (paginated) GET

The full import archive, newest first by `created_at`, cursor paginated. Use this to page back through history; use `/api/imports/working-set` for the bounded set a UI renders.

Retry an import POST

Re-enqueue a finished import, reusing the original source. The record is reset to `pending` and `processing_started_at` is re-stamped, which gives the attempt a full retry budget rather than inheriting the elapsed time of the previous one.