Retrieves the current processing status of an uploaded source. Use this endpoint to poll source readiness before including it in chat or search requests.
Status Values:
processing: Source is being parsed and indexed (typically takes 10-60 seconds depending on file size)success: Source is ready for use in conversationsfailed: Processing failed (check file format, size, or content validity)Best Practice: Poll this endpoint with exponential backoff until status is success before initiating chat/search requests.
The unique identifier (UUID) of the source returned from POST /v1/sources
Source status retrieved successfully
Source identifier
"456e7890-e89b-12d3-a456-426614174001"
Current processing status:
processing: File is being parsed and indexedsuccess: Source is ready for use in conversationsfailed: Processing failed, source cannot be usedprocessing, success, failed "success"
Error message if status is 'failed' (optional)
"File format not supported"