# Create documents

Creates one or more documents of a given kind, returning the IDs of newly created documents and any pre-existing duplicates.

Request:
documents     - List of documents to create. Each entry includes:
kind        - The Kind name this document belongs to.
doc         - The document body as an arbitrary JSON value.
externalId - Optional identifier from an external system for deduplication and cross-reference.

Response:
ids            - IDs of the newly created documents.
existingIds   - IDs of pre-existing documents that matched by externalId (not re-created).

Endpoint: POST /api/v1/document/create
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `documents` (array)

  - `documents.kind` (string)
    Rule data fields

  - `documents.doc` (any)

  - `documents.externalId` (string)
    Rule data fields

## Response 200 fields (application/json):

  - `ids` (array)

  - `existingIds` (array)

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 403 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 499 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)

## Response 501 fields (application/json):

  - `message` (string)

## Response 503 fields (application/json):

  - `message` (string)

## Response 504 fields (application/json):

  - `message` (string)