---
title: "Start Extraction Job"
method: POST
path: "/document/extraction/start_job"
tags: ["Extraction"]
---

# Start Extraction Job

`POST /document/extraction/start_job`

## Endpoint to Start an Extraction Job
This endpoint starts an extraction job by adding all registered files to the SQS queue for processing.

***

## Request Body

| Field               | Type   | Description                      |
|---------------------|--------|----------------------------------|
| extraction_job_id   | str    | The ID of the extraction job.    |

***

## Response Body

| Field               | Type   | Description                      |
|---------------------|--------|----------------------------------|
| extraction_job_id   | str    | The ID of the extraction job.    |
| total_files         | int    | The total number of files registered for the job. |
| status              | str    | The status of the extraction job. Returns STARTED if the job is started successfully. |

***

#### Errors

- **400**: If the job is already started or completed.
- **404**: If the job ID is not found.
- **500**: If any other error occurs during the start process.

## Request body

- StartExtractionJobRequest
  - `extraction_job_id` string, required

## Response `200`

Successful Response

- StartExtractionJobResponse
  - `extraction_job_id` string, required
  - `total_files` integer, required
  - `status` 'CREATED' | 'STARTED' | 'COMPLETED' | 'COMPLETED_WITH_ERRORS' | 'FAILED'

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/aws-samples/apis/generative-ai-foundational-platform-api.md) · [All operations](https://skmtc.dev/aws-samples/apis/generative-ai-foundational-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aws-samples/generative-ai-foundational-platform-api/revisions/8831d08902e9/schema)