Ingest Url

Ingest a URL directly (for Add to Library button).

Smart routing:

• YouTube URLs -> existing Supadata pipeline
• Article URLs -> Firecrawl extraction

Returns immediately with result (no job tracking).

POST /api/ingest/url

Ingest Url

cURL

curl --request POST \
  --url https://api.example.com/api/ingest/url \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "destination": {
    "project_id": "<string>",
    "type": "library"
  },
  "force": false,
  "namespace": "global",
  "taxonomy_labels": [
    "<string>"
  ]
}
'

200

{
  "status": "ok",
  "chunks_created": 1,
  "error": "<string>",
  "source_id": "<string>",
  "title": "<string>"
}

Body

application/json

Request to ingest a URL directly (for Add to Library button).

url · string · required

Minimum string length: 1

destination · IngestDestination · object

Where ingested content should be routed.

Show child attributes

force · boolean · default: false

namespace · string · default: global

taxonomy_labels · string[] | null

Response

200

application/json

Successful Response

Response from URL ingestion.

status · enum<string> · required

Available options: ok, error

chunks_created · integer | null

Required range: x >= 0

error · string | null

source_id · string | null

title · string | null