Skip to content
Framework Docs

Get Pipeline Document Status

ManagedIngestionStatusResponse pipelines().documents().getStatus(DocumentGetStatusParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
GET/api/v1/pipelines/{pipeline_id}/documents/{document_id}/status

Return a single document for a pipeline.

ParametersExpand Collapse
DocumentGetStatusParams params
String pipelineId
Optional<String> documentId
ReturnsExpand Collapse
class ManagedIngestionStatusResponse:
Status status

Status of the ingestion.

One of the following:
NOT_STARTED("NOT_STARTED")
IN_PROGRESS("IN_PROGRESS")
SUCCESS("SUCCESS")
ERROR("ERROR")
PARTIAL_SUCCESS("PARTIAL_SUCCESS")
CANCELLED("CANCELLED")
Optional<LocalDateTime> deploymentDate

Date of the deployment.

formatdate-time
Optional<LocalDateTime> effectiveAt

When the status is effective

formatdate-time
Optional<List<Error>> error

List of errors that occurred during ingestion.

String jobId

ID of the job that failed.

formatuuid
String message

List of errors that occurred during ingestion.

Step step

Name of the job that failed.

One of the following:
MANAGED_INGESTION("MANAGED_INGESTION")
DATA_SOURCE("DATA_SOURCE")
FILE_UPDATER("FILE_UPDATER")
PARSE("PARSE")
TRANSFORM("TRANSFORM")
INGESTION("INGESTION")
METADATA_UPDATE("METADATA_UPDATE")
Optional<String> jobId

ID of the latest job.

formatuuid

Get Pipeline Document Status

package com.llamacloud_prod.api.example;

import com.llamacloud_prod.api.client.LlamaCloudClient;
import com.llamacloud_prod.api.client.okhttp.LlamaCloudOkHttpClient;
import com.llamacloud_prod.api.models.pipelines.ManagedIngestionStatusResponse;
import com.llamacloud_prod.api.models.pipelines.documents.DocumentGetStatusParams;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        LlamaCloudClient client = LlamaCloudOkHttpClient.fromEnv();

        DocumentGetStatusParams params = DocumentGetStatusParams.builder()
            .pipelineId("182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e")
            .documentId("document_id")
            .build();
        ManagedIngestionStatusResponse managedIngestionStatusResponse = client.pipelines().documents().getStatus(params);
    }
}
{
  "status": "NOT_STARTED",
  "deployment_date": "2019-12-27T18:11:19.117Z",
  "effective_at": "2019-12-27T18:11:19.117Z",
  "error": [
    {
      "job_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "message": "message",
      "step": "MANAGED_INGESTION"
    }
  ],
  "job_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
}
Returns Examples
{
  "status": "NOT_STARTED",
  "deployment_date": "2019-12-27T18:11:19.117Z",
  "effective_at": "2019-12-27T18:11:19.117Z",
  "error": [
    {
      "job_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "message": "message",
      "step": "MANAGED_INGESTION"
    }
  ],
  "job_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
}