Gets a single ingestion operation by ID.
Returns the full state of one operation: progress counters, what went wrong if it failed and what to do about it, and computed embedding cost based on the asset's current pricing. This is the endpoint that clients should poll after `POST /assets`, `POST /assets:file`, or `POST /assets/{asset}:refresh` to detect completion. Polling cadence of a few seconds is appropriate; the underlying record is updated in place as workers make progress.
Authorization
Bearer JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.
In: header
Path Parameters
The operation ID.
uuidThe tenant identifier
Response Body
curl -X GET "https://api.fruxon.com/v1/tenants/string/assets/string/operations/497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"id": "00000000-0000-0000-0000-000000000000",
"assetId": "00000000-0000-0000-0000-000000000000",
"tenantId": "00000000-0000-0000-0000-000000000000",
"type": "string",
"status": "PENDING",
"done": false,
"startedAt": 0,
"completedAt": 0,
"itemsProcessed": 0,
"itemsTotal": 0,
"tokenCount": 0,
"chunkCount": 0,
"cost": 0,
"errorMessage": "string",
"errorNextStep": "string",
"createdBy": "string"
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}Gets a single document by its ID.
Returns the document's metadata and current ingestion status, without its chunks. Use this when the listing-page payload is insufficient — for example to inspect the source URL or last-ingested timestamp of one document. To retrieve the document's indexed text fetch its chunks via `GET /assets/{asset}/documents/{document}/chunks`.
Initiates an OAuth flow for an asset source type that supports OAuth (e.g
Generates a per-request state-bound authorization URL for a source type whose descriptor (see `GET /assets/sourceTypes`) advertises OAuth support. The frontend opens the URL in a popup; on completion the OAuth callback redirects to a success page carrying a single-use credential key that must be exchanged via `GET /assets/oauthCredentials`. Returns 400 for source types that do not support OAuth.