---
title: "Start or Stop an ingestion job on a knowledge base datasource"
method: POST
path: "/rag/engines/knowledge-base/datasource/ingestion"
tags: ["RAG", "Ingestion"]
---

# Start or Stop an ingestion job on a knowledge base datasource

`POST /rag/engines/knowledge-base/datasource/ingestion`

## Request body

- KnowledgeBaseDataSourceIngestionRequest
  - `kb_id` string, required
  - `data_source_id` string, required
  - `ingestion_job_id` string
  - `action` 'start' | 'stop', required

## Response `200`

response

- union
  - object
    - `ok` boolean
    - `data` IngestionJob
      - `dataSourceId` string
      - `description` string
      - `ingestionJobId` string
      - `knowledgeBaseId` string
      - `statistics` IngestionJobStatistics
        - `numberOfDocumentsDeleted` integer
        - `numberOfDocumentsFailed` integer
        - `numberOfDocumentsScanned` integer
        - `numberOfMetadataDocumentsModified` integer
        - `numberOfMetadataDocumentsScanned` integer
        - `numberOfModifiedDocumentsIndexed` integer
        - `numberOfNewDocumentsIndexed` integer
      - `status` 'STARTING' | 'IN_PROGRESS' | 'COMPLETE' | 'FAILED' | 'STOPPING' | 'STOPPED'
      - `startedAt` string, date-time
      - `updatedAt` string, date-time
  - Error
    - `error` boolean
    - `message` string[]

---

[API](https://skmtc.net/aws-samples/apis/gaia-rest-api.md) · [All operations](https://skmtc.net/aws-samples/apis/gaia-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws-samples/gaia-rest-api/versions/c61f71119116/schema)