---
title: "Create Ingest Job From Bucket"
method: POST
path: "/api/v1/ingestion/buckets"
tags: ["ingestion > ingest"]
---

# Create Ingest Job From Bucket

`POST /api/v1/ingestion/buckets`

Ingest assets from a bucket scan

## Headers

- `Authorization` string, required

## Request body

- IngestionCreateIngestJobFromBucketRequest
  - `dataset_id` string, uuid, required
  - `connection_name` string, nullable
  - `path` string, nullable
  - `spec` IngestionBucketSpec
    - `bucket` string, required
    - `prefix` string
    - `provider` 'aws'
  - `source_path` string, nullable
  - `source_spec` IngestionBucketSpec
    - `bucket` string, required
    - `prefix` string
    - `provider` 'aws'
  - `max_depth` integer — Max depth of recursion under a prefix

## Response `202`

Successful Response

- IngestionCreateIngestJobResponse
  - `id` string, required
  - `org_id` string, required
  - `dataset_id` string, uuid, required
  - `connection_name` string, nullable
  - `job_type` 'unspecified' | 'assets' | 'file' | 'bucket' | 'metadata', required
  - `details` union, required
    - IngestionAssetsJobDetails
      - `assets` IngestionAssetJobDetail[], required
        - `asset` IngestionIngestJobAsset, required
          - `source_path` string, required
          - `metadata` object, nullable
          - `asset_type` 'unspecified' | 'image' | 'video'
        - `asset_id` string, uuid, nullable
        - `error` string, nullable
    - IngestionFileJobDetails
      - `file` IngestionCreateIngestJobFromFileRequest, required
        - `dataset_id` string, uuid, required
        - `source_path` string, required
        - `connection_name` string, nullable
        - `file_type` 'unspecified' | 'csv' | 'json'
    - IngestionBucketJobDetails
      - `path` string, required
      - `spec` IngestionBucketSpec, required
        - `bucket` string, required
        - `prefix` string
        - `provider` 'aws'
      - `max_depth` integer
    - IngestionMetadataUpdateJobDetails
      - `accepted` IngestionInternalAssetMetadataUpdate[], required
        - `asset_id` string, uuid, required
        - `source_path` string, nullable, required
        - `asset_type` 'image' | 'video', required
        - `metadata` object, nullable
      - `invalid_assets` IngestionExistingAssetMetadataUpdate[], required
        - `asset_id` string, uuid, nullable
        - `source_path` string, nullable
        - `asset_type` 'image' | 'video', required
        - `metadata` object, nullable
  - `request_type` 'submit'
  - `status` 'completed' | 'failed' | 'in_progress' | 'pending' | 'paused' | 'stopping' | 'stopped' — Enum of Ingest Job Status.
  - `created_dt` string, date-time, required
  - `updated_dt` string, date-time, nullable
  - `total_assets` integer, nullable
  - `processed_assets` integer
  - `errored_assets` integer
  - `request_id` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coactive/api-reference/revisions/1223758be9ba/schema)