POST /v2/parse

Parse a document image into structured output. Use output_format to select blocks or markdown (default).

Currently supports document.type = image_url only (data URI or remote http(s) image URL). PDF / file URL inputs are not yet supported.

Image limits: 20 MB file size; 50 megapixels or 200 MB decoded (whichever is exceeded first).

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

X-Client-Name String No

The name of the project that is making the request.

Request body fields

Name Type Required Description
output_format String No

Selects the page payload shape in the response. Defaults to "markdown".

  • "markdown": each page includes markdown content. Tables are inlined as HTML, and images are referenced as ![<description>](<image_id>) with matching entries in page.markdown.images.
  • "blocks": each page includes an ordered blocks array of text, image, and table content regions, including bounding boxes where available.

Valid values:

  • "markdown"
  • "blocks"

Default value: "markdown"

document Object Yes

Document to parse. Currently only image_url documents are supported.

document.type String Yes

Discriminator for the document payload.

Valid values:

  • "image_url"
document.image_url String Yes

Image URL or base64 data URI to parse.

Limits:

  • Maximum file size: 20 MB (compressed upload, download, or decoded data-URI payload)
  • Maximum decoded size: 50 megapixels or 200 MB decompressed (whichever is exceeded first)
model String Yes

The name of a compatible Cohere parse model.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.