---
title: "Ingest a document into a source"
method: POST
path: "/v1/sources/{id}/ingest"
tags: ["Sources"]
---

# Ingest a document into a source

`POST /v1/sources/{id}/ingest`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/sources/{id}/ingest`
- Auth: HTTP bearer

Multipart upload of one document (≤500 MB) into the source for extraction. Alias of POST /v1/sources/{id}/documents. Requires the extract scope.

## Path parameters

- `id` string, uuid, required

## Response `200`

{ document_id, filename, size_bytes, status: queued, processing_mode, source_id, links } — same shape as POST /v1/sources/{id}/documents (this route is an alias); duplicate branch is { status: duplicate, message, document_id, existing_document_id, filename, size_bytes }

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)