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

# Create Ingest Job From File

`POST /api/v1/ingestion/files`

Ingest assets from a CSV or JSON file

## Request body

- IngestionCreateIngestJobFromFileRequest
  - `dataset_id` string, uuid, required
  - `source_path` string, required
  - `connection_name` string, nullable
  - `file_type` 'unspecified' | 'csv' | 'json'

## 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

## Changes

- **2026-09-17** `23dbda5f105c` — 1 breaking, 1 warning, 2 info
  - added `#/components/schemas/ingestion_CreateIngestJobResponseDetails` to the `details` response property `oneOf` list for the response status `202`
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `HTTPBearer` was added to the API
  - removed `#/components/schemas/ingestion:CreateIngestJobResponseDetails` from the `details` response property `oneOf` list for the response status `202`
- **2026-09-12** `3683abf6922b` — 1 info
  - api operation id `create-ingest-job-from-file-api-v-1-ingestion-files-post` removed and replaced with `ingestion_ingest_create_ingest_job_from_file_api_v1_ingestion_files_post`

[Change history](https://skmtc.dev/coactive/apis/api-reference/changes/api/v1/ingestion/files/post.md)

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/coactive/apis/api-reference/revisions/23dbda5f105c?raw)