---
title: "Ingest from URL"
method: POST
path: "/v1/tables/{table_name}/ingest/url"
tags: ["ingestion"]
---

# Ingest from URL

`POST /v1/tables/{table_name}/ingest/url`

Enqueue content from a URL for background ingestion. Supports web pages, YouTube videos (with transcription), and other online resources.

Returns a `job_id`. Poll `GET /v1/jobs/{job_id}` for status and the resulting document ID.

## Path parameters

- `table_name` string, required

## Request body

- IngestUrlBody
  - `url` string, uri, required — URL to ingest (web page, YouTube video, etc.)
  - `generate_summaries` boolean — Whether to generate LLM summaries (default: true)

## Response `202`

Ingestion job queued

- JobStatusResponse
  - `job_id` string — Unique job ID
  - `status` 'queued' | 'processing' | 'completed' | 'failed' — Current job status
  - `progress` string — Progress message (only present when status is 'processing')
  - `result` IngestResponse
    - `document_id` string — Unique document ID
    - `title` string — Document title
    - `total_nodes` integer — Total number of nodes in the tree
    - `max_depth` integer — Maximum depth of the tree
    - `stats` IngestStats
      - `chars_extracted` integer — Characters extracted from source
      - `chunks_created` integer — Text chunks created
      - `nodes_created` integer — Tree nodes created
      - `summaries_generated` integer — Summaries generated by LLM
      - `total_time_ms` integer — Total processing time in milliseconds
  - `error` string — Error message (only present when status is 'failed')
  - `created_at` string, date-time — Job creation timestamp
  - `updated_at` string, date-time — Last status update timestamp

## Other responses

- `404` — Table not found
- `422` — Validation failed (invalid URL)

---

[API](https://skmtc.net/brainfish-ai/apis/reasondb-api.md) · [All operations](https://skmtc.net/brainfish-ai/apis/reasondb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brainfish-ai/reasondb-api/versions/f8665c1a5239/schema)