GET
/
v1
/
artifacts
/
ingest
/
async
/
{task_id}
{
  "task_id": "123e4567-e89b-12d3-a456-426614174000",
  "task_status": "SUCCESS",
  "task_result": {
    "object": "list",
    "model": "private-gpt",
    "data": [
      {
        "object": "ingest.document",
        "artifact": "annual_report",
        "doc_metadata": {
          "file_name": "report.pdf",
          "page_count": 45,
          "department": "finance"
        }
      }
    ]
  }
}

Path Parameters

​
task_id
string
required

Unique identifier of the ingestion task to check status for

Examples:

"123e4567-e89b-12d3-a456-426614174000"

Response

Successfully retrieved task status and results

Represents the status of an asynchronous task, including its ID, status, and result.

​
task_id
string
required

Unique identifier of the task being monitored

Examples:

"123e4567-e89b-12d3-a456-426614174000"

​
task_status
string
required

Current execution status of the task. Common values: PENDING, SUCCESS, FAILURE, REVOKED

Examples:

"PENDING"

"SUCCESS"

"FAILURE"

"REVOKED"

​
task_result
required

Task execution result. Contains typed result data on success, error message string on failure, or None for pending/deletion tasks Response model for successful document ingestion operations.

Examples:
{
  "data": [
    {
      "artifact": "quarterly_report_q1",
      "doc_metadata": {
        "department": "finance",
        "file_name": "Q1_Report.pdf",
        "page_number": 1,
        "total_pages": 15
      },
      "object": "ingest.document"
    }
  ],
  "model": "private-gpt",
  "object": "list"
}