POST Document

This API allows you to upload a document.

API Description

Endpoint:

POST /documents

Query params:

Variable Required Description
documentId No The reference ID for the document
documentTitle No The title of the document
documentUrl No The URL of the document

Request body:

Variable Description
inputStream The input stream containing the document content

Responses:

Type Description
DocumentId The ID of the document. A new documentId is generated if not provided in the query parameter

Examples

Upload a Document

The following example uploads a document from a file named “example.pdf” without specifying a document title or URL.

curl -X 'POST' \
  'http://localhost:8761/documents' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/octet-stream' \
  --data-binary '@example.pdf'

The following example uploads a document from URL.

curl -X 'POST' \
  'http://localhost:8761/documents?documentUrl=https%3A%2F%2Fdemo.arender.io%2Fdocs%2Fdemo%2FPDFReference15_v5.pdf' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/octet-stream' \
  -d ''