Re-ingest file from source URL

Re-downloads the file content from its original source_url, replaces the file on disk, and re-runs the RAG ingestion pipeline — regenerating embeddings, summary, and metadata. The existing Upload record is updated in-place (no new record is created).

Only works for files that were originally uploaded via URL (source_url must be set). Collection membership is preserved through the re-ingestion process.

YouTube URLs are automatically detected and handled specially: metadata is fetched via oEmbed, transcripts are extracted with timestamps, and the upload thumbnail and embed_url are updated. If no captions are available and skipIndexing is false, the request fails.

On failure, the upload’s original status is restored to prevent file cards from getting stuck in a “processing” state.

PUT /api/user/reingest/{fileId}

Re-ingest file from source URL

cURL

curl --request PUT \
  --url https://pria.praxislxp.com/api/user/reingest/{fileId} \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "skipIndexing": false
}
'

200

{
  "success": true,
  "message": "File re-ingested from URL",
  "data": {
    "_id": "<string>",
    "filename": "<string>",
    "originalname": "<string>",
    "mimetype": "<string>",
    "created": "2023-11-07T05:31:56Z",
    "filesize": 123,
    "status": "inactive",
    "thumbnail": "<string>",
    "user": "<string>",
    "institution": "<string>",
    "account_shared": true,
    "file_summary": "<string>",
    "file_title": "<string>",
    "file_url": "<string>",
    "tokens_used": 123,
    "is_public": false,
    "is_private": false,
    "file_dimensions": "<string>",
    "file_authors": "<string>",
    "embeddings_model": "<string>",
    "summary_model": "<string>",
    "image_analysis_model": "<string>",
    "googleDriveFileId": "<string>",
    "googleDriveModifiedTime": "2023-11-07T05:31:56Z",
    "ragHitCount": 0,
    "lastRagHitAt": "2023-11-07T05:31:56Z",
    "vaultHealthScore": 123,
    "fileOnDisk": true,
    "owner_data": {
      "email": "[e-mail]",
      "fname": "<string>",
      "lname": "<string>",
      "institution": "<string>"
    },
    "institution_data": {
      "name": "<string>",
      "ainame": "<string>"
    },
    "institution_name": "<string>",
    "institution_display_name": "<string>",
    "index": 123
  }
}

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-ingest

Body

application/json

skipIndexing · boolean · default: false

When true, re-downloads the content but skips RAG embedding generation. The file is set to status 'active' with no new embeddings. For YouTube URLs without captions, this allows creating a metadata-only file instead of failing.

Response

200

application/json

Re-ingest result. Check the success field - async RAG errors also return HTTP 200 with success: false.

Option 1

Option 2

Successful re-ingestion

success · boolean

Example:

true

message · string

Example:

"File re-ingested from URL"

data · object

Show child attributes