Problem processing via N8N

[gmakstutis]

My JSON request is:

{ "options": { "from_formats": [ "docx", "pptx", "html", "image", "pdf", "asciidoc", "md", "xlsx" ], "to_formats": [ "md", "json", "html", "text", "doctags" ], "image_export_mode": "placeholder", "do_ocr": true, "force_ocr": false, "ocr_engine": "easyocr", "ocr_lang": [ "fr", "de", "es", "en" ], "pdf_backend": "dlparse_v2", "table_mode": "fast", "abort_on_error": false, "do_table_structure": true, "include_images": true, "images_scale": 2 }, "http_sources": [ { "url": "https://arxiv.org/pdf/2206.01062" } ] }

This is taken directly from the Docs.

When I try to execute the n8n node, it fails with "field required" - but I cannot see what 'field' it is missing.

This is what the n8n node looks like:

The error info from n8n is:

422 - "{"detail":[{"type":"missing","loc":["body","sources"],"msg":"Field required","input":{"options":{"from_formats":["docx","pptx","html","image","pdf","asciidoc","md","xlsx"],"to_formats":["md","json","html","text","doctags"],"image_export_mode":"placeholder","do_ocr":true,"force_ocr":false,"ocr_engine":"easyocr","ocr_lang":["fr","de","es","en"],"pdf_backend":"dlparse_v2","table_mode":"fast","abort_on_error":false,"do_table_structure":true,"include_images":true,"images_scale":2},"http_sources":[{"url":"https://arxiv.org/pdf/2206.01062"}]}}]}"

It would be a huge help if someone could tell me what I'm missing.

Many thinks

[dosubot]

Hi @gmakstutis! I'm Dosu and I’m helping the docling-serve team.

The error happens because the API expects a field called sources, not http_sources. You also need to specify the kind of source. Try this payload instead:

{
  "options": {
    "from_formats": [
      "docx", "pptx", "html", "image", "pdf", "asciidoc", "md", "xlsx"
    ],
    "to_formats": [
      "md", "json", "html", "text", "doctags"
    ],
    "image_export_mode": "placeholder",
    "do_ocr": true,
    "force_ocr": false,
    "ocr_engine": "easyocr",
    "ocr_lang": ["fr", "de", "es", "en"],
    "pdf_backend": "dlparse_v2",
    "table_mode": "fast",
    "abort_on_error": false,
    "do_table_structure": true,
    "include_images": true,
    "images_scale": 2
  },
  "sources": [
    {
      "kind": "http",
      "url": "https://arxiv.org/pdf/2206.01062"
    }
  ]
}

Replace http_sources with sources, and add "kind": "http" to each source object. That should resolve the "field required" error see example.

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[gmakstutis]

Hi @dosu,

That fixed it! Thank you.

It is a bit confusing, as the docs (https://github.com/docling-project/docling-serve/blob/main/docs/usage.md) show:

Simple payload example:

{
  "http_sources": [{"url": "https://arxiv.org/pdf/2206.01062"}]
}

In any case, that you, very much, for such a quick response.

[dosubot]

You're welcome—glad it worked!

The confusion is totally understandable. The docs used to show http_sources for the older v1alpha API, but the current v1 API now requires a sources array with a kind field (like "kind": "http"). The maintainers recently updated the documentation and examples to match the new format, so future requests should use sources instead of http_sources see PR #306, PR #308, and PR #307.

If you run into anything else, just let me know!

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}    

[dolfim-ibm]

From the message above I assume it was solved.