File Job Status
curl --request GET \
--url http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}import requests
url = "http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "8080",
CURLOPT_URL => "http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"job_id": "job-1fad681df00046c0a7f950daeb52f120",
"job_type": "file_ingest",
"namespace_name": "my-documents",
"file_id": "a1b2c3d4e5f67890",
"absolute_path": "/uploads/document.pdf",
"status": "completed",
"chunks_total": 1,
"chunks_processed": 1,
"summaries_created": 1,
"items_deleted": 0,
"last_error": null,
"started_at": "2026-06-05T18:53:24Z",
"updated_at": "2026-06-05T18:53:37Z",
"finished_at": "2026-06-05T18:53:37Z"
}
{
"job_id": "job-39e12e05109c45bb8f477edb1912964d",
"job_type": "file_delete",
"namespace_name": "my-documents",
"file_id": "a1b2c3d4e5f67890",
"absolute_path": "/uploads/document.pdf",
"status": "completed",
"chunks_total": 2,
"chunks_processed": 2,
"summaries_created": 0,
"items_deleted": 2,
"last_error": null,
"started_at": "2026-06-05T18:53:39Z",
"updated_at": "2026-06-05T18:53:39Z",
"finished_at": "2026-06-05T18:53:39Z"
}
File storage
File Job Status
Poll file upload or file delete job progress.
GET
/
namespaces
/
{namespace_name}
/
file-jobs
/
{job_id}
File Job Status
curl --request GET \
--url http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}import requests
url = "http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "8080",
CURLOPT_URL => "http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:8080/namespaces/{namespace_name}/file-jobs/{job_id}")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"job_id": "job-1fad681df00046c0a7f950daeb52f120",
"job_type": "file_ingest",
"namespace_name": "my-documents",
"file_id": "a1b2c3d4e5f67890",
"absolute_path": "/uploads/document.pdf",
"status": "completed",
"chunks_total": 1,
"chunks_processed": 1,
"summaries_created": 1,
"items_deleted": 0,
"last_error": null,
"started_at": "2026-06-05T18:53:24Z",
"updated_at": "2026-06-05T18:53:37Z",
"finished_at": "2026-06-05T18:53:37Z"
}
{
"job_id": "job-39e12e05109c45bb8f477edb1912964d",
"job_type": "file_delete",
"namespace_name": "my-documents",
"file_id": "a1b2c3d4e5f67890",
"absolute_path": "/uploads/document.pdf",
"status": "completed",
"chunks_total": 2,
"chunks_processed": 2,
"summaries_created": 0,
"items_deleted": 2,
"last_error": null,
"started_at": "2026-06-05T18:53:39Z",
"updated_at": "2026-06-05T18:53:39Z",
"finished_at": "2026-06-05T18:53:39Z"
}
Overview
Returns status for jobs started by Upload file or Delete file index. The same endpoint handles both job types — checkjob_type.
Path parameters
string
required
Namespace the job belongs to.
string
required
Job id from upload or delete response.
Request example
curl "http://localhost:8080/namespaces/my-documents/file-jobs/job-1fad681df00046c0a7f950daeb52f120"
Response fields
string
Job id.
string
"file_ingest" or "file_delete".string
Target namespace.
string
running, completed, or failed.string
File id (set during upload/delete).
string
Container path for the file.
number
Total chunks expected (ingest) or to delete (delete job).
number
Chunks processed so far (upload).
number
Summary chunks created (upload).
number
Items removed from the index (delete).
string
Error message when
status is failed.string
ISO 8601 start time.
string
ISO 8601 last update time.
string
ISO 8601 end time when completed or failed.
{
"job_id": "job-1fad681df00046c0a7f950daeb52f120",
"job_type": "file_ingest",
"namespace_name": "my-documents",
"file_id": "a1b2c3d4e5f67890",
"absolute_path": "/uploads/document.pdf",
"status": "completed",
"chunks_total": 1,
"chunks_processed": 1,
"summaries_created": 1,
"items_deleted": 0,
"last_error": null,
"started_at": "2026-06-05T18:53:24Z",
"updated_at": "2026-06-05T18:53:37Z",
"finished_at": "2026-06-05T18:53:37Z"
}
{
"job_id": "job-39e12e05109c45bb8f477edb1912964d",
"job_type": "file_delete",
"namespace_name": "my-documents",
"file_id": "a1b2c3d4e5f67890",
"absolute_path": "/uploads/document.pdf",
"status": "completed",
"chunks_total": 2,
"chunks_processed": 2,
"summaries_created": 0,
"items_deleted": 2,
"last_error": null,
"started_at": "2026-06-05T18:53:39Z",
"updated_at": "2026-06-05T18:53:39Z",
"finished_at": "2026-06-05T18:53:39Z"
}
Related
Was this page helpful?