Skip to main content

Ingestion

What this page is for

Use ingest endpoints to start a draft session from supported source types.

Endpoints

  • POST /api/ingest/web
  • POST /api/ingest/manual
  • POST /api/ingest/file — see File Upload

Steps

  1. Choose source type.
  2. Send request with X-User-ID.
  3. Store returned sessionId.
  4. Move to session operations.

Verify

  • Response contains sessionId, sourceType, and timestamps.
  • GET /api/session/<id> returns draft state.

Troubleshooting

  • Web ingest timeout: tune WEB_FETCH_TIMEOUT.

All ingest endpoints accept an optional chunkingConfig — see Configurable Chunking.

Next steps