Skip to main content
POST
/
api
/
user
/
files
/
{fileId}
/
reprocess
Re-queue an existing file for ingestion
curl --request POST \
  --url https://pria.praxislxp.com/api/user/files/{fileId}/reprocess \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '{
  "mode": "full"
}'
{
  "success": true,
  "queued": true,
  "mode": "full",
  "message": "File re-queued for processing",
  "uploadId": "<string>",
  "ingestion": {
    "phase": "queued",
    "attempts": 0,
    "enqueuedAt": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
x-access-token
string
header
required

JWT token passed in x-access-token header

Path Parameters

​
fileId
string
required

The file ID to re-queue

Body

application/json
​
mode
enum<string>
default:full

full wipes all chunks/embeddings and restarts from the queued phase. embed keeps existing chunks but clears the embedded flag + provider-specific vector fields and resumes at the embed phase — useful after changing the embedding model.

Available options:
full,
embed

Response

File has been queued for reprocessing

​
success
boolean
Example:

true

​
queued
boolean
Example:

true

​
mode
enum<string>

The reprocess mode that was applied

Available options:
full,
embed
Example:

"full"

​
message
string
Example:

"File re-queued for processing"

​
uploadId
string

MongoDB ObjectId of the re-queued Upload record

​
ingestion
object