---
title: "POST /knowledgebases/{knowledgeBaseId}/datasources/{dataSourceId}/ingestionjobs/"
method: POST
path: "/knowledgebases/{knowledgeBaseId}/datasources/{dataSourceId}/ingestionjobs/"
---

# POST /knowledgebases/{knowledgeBaseId}/datasources/{dataSourceId}/ingestionjobs/

`POST /knowledgebases/{knowledgeBaseId}/datasources/{dataSourceId}/ingestionjobs/`

Lists the data ingestion jobs for a data source. The list also includes information about each job.

## Path parameters

- `knowledgeBaseId` string, required
- `dataSourceId` string, required

## Request body

- object
  - `filters` IngestionJobFilter[] — Contains information about the filters for filtering the data.
    - `attribute` 'STATUS', required — The name of field or attribute to apply the filter.
    - `operator` 'EQ', required — The operation to apply to the field or attribute.
    - `values` IngestionJobFilterValue[], required — A list of values that belong to the field or attribute.
  - `sortBy` object — The parameters of sorting the data.
    - `attribute` 'STATUS' | 'STARTED_AT' — The name of field or attribute to apply sorting of data.
    - `order` 'ASCENDING' | 'DESCENDING' — The order for sorting the data.
  - `maxResults` integer — The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the <code>nextToken</code> field when making another request to return the next batch of results.
  - `nextToken` string — If the total number of results is greater than the <code>maxResults</code> value provided in the request, enter the token returned in the <code>nextToken</code> field in the response in this field to return the next batch of results.

## Response `200`

Success

- ListIngestionJobsResponse
  - `ingestionJobSummaries` IngestionJobSummary[], required — A list of data ingestion jobs with information about each job.
    - `knowledgeBaseId` string, required — The unique identifier of the knowledge base for the data ingestion job.
    - `dataSourceId` string, required — The unique identifier of the data source for the data ingestion job.
    - `ingestionJobId` string, required — The unique identifier of the data ingestion job.
    - `description` string — The description of the data ingestion job.
    - `status` 'STARTING' | 'IN_PROGRESS' | 'COMPLETE' | 'FAILED' | 'STOPPING' | 'STOPPED', required — The status of the data ingestion job.
    - `startedAt` string, date-time, required — The time the data ingestion job started.
    - `updatedAt` string, date-time, required — The time the data ingestion job was last updated.
    - `statistics` object — Contains statistics for the data ingestion job.
      - `numberOfDocumentsScanned` integer — The total number of source documents that were scanned. Includes new, updated, and unchanged documents.
      - `numberOfMetadataDocumentsScanned` integer — The total number of metadata files that were scanned. Includes new, updated, and unchanged files.
      - `numberOfNewDocumentsIndexed` integer — The number of new source documents in the data source that were successfully indexed.
      - `numberOfModifiedDocumentsIndexed` integer — The number of modified source documents in the data source that were successfully indexed.
      - `numberOfMetadataDocumentsModified` integer — The number of metadata files that were updated or deleted.
      - `numberOfDocumentsDeleted` integer — The number of source documents that were deleted.
      - `numberOfDocumentsFailed` integer — The number of source documents that failed to be ingested.
      - `numberOfDocumentsSkipped` integer — The number of source documents that were skipped during ingestion.
  - `nextToken` string — If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.

## Other responses

- `480` — ThrottlingException
- `481` — AccessDeniedException
- `482` — ValidationException
- `483` — InternalServerException
- `484` — ResourceNotFoundException

---

[API](https://skmtc.net/aws/apis/bedrock-agent.md) · [All operations](https://skmtc.net/aws/apis/bedrock-agent/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/bedrock-agent/versions/a3b2356f17da/schema)