Skip to main content
GET
/
v1
/
artifacts
/
ingest
/
async
/
{task_id}
Check Ingestion Task Status
curl --request GET \
  --url https://{base_url}/gpt/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

Example:

"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

Example:

"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

Response model for successful document ingestion operations.

Example:

null