Skip to main content
POST
/
api
/
document-stores
/
{id}
/
upload
Upload file to document store
curl --request POST \
  --url https://platform.kodexa.ai/api/document-stores/{id}/upload \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form file='@example-file'
{
  "changeSequence": 123,
  "contentObjects": [
    {
      "changeSequence": 123,
      "contentMetadata": {},
      "contentType": "<string>",
      "created": "2023-11-07T05:31:56Z",
      "createdOn": "2023-11-07T05:31:56Z",
      "docTransitionType": "<string>",
      "documentFamilyId": "<string>",
      "documentTaxonValidations": [
        {
          "taxonPath": "<string>",
          "taxonomyRef": "<string>",
          "validation": {
            "conditional": true,
            "conditionalFormula": "<string>",
            "description": "<string>",
            "detailFormula": "<string>",
            "disabled": true,
            "exceptionId": "<string>",
            "messageFormula": "<string>",
            "name": "<string>",
            "overridable": true,
            "ruleFormula": "<string>",
            "supportArticleId": "<string>"
          }
        }
      ],
      "documentVersion": "<string>",
      "id": "b1234567-89ab-cdef-0123-456789abcdef",
      "index": 123,
      "metadata": {},
      "mixins": [
        "<string>"
      ],
      "modified": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "size": 245760,
      "source": {
        "checksum": "<string>",
        "cid": "<string>",
        "connector": "<string>",
        "created": "<string>",
        "document_family_id": "<string>",
        "headers": {},
        "last_modified": "<string>",
        "lineage_document_uuid": "<string>",
        "mime_type": "<string>",
        "original_filename": "<string>",
        "original_path": "<string>",
        "source_document_uuid": "<string>"
      },
      "sourceContentObjectId": "<string>",
      "storeRef": "<string>",
      "summary": "<string>",
      "updatedOn": "2023-11-07T05:31:56Z",
      "uuid": "<string>"
    }
  ],
  "created": "2023-11-07T05:31:56Z",
  "createdOn": "2023-11-07T05:31:56Z",
  "deleteUserEmail": "<string>",
  "deleted": true,
  "deletedDate": "2023-11-07T05:31:56Z",
  "documentStatus": "<string>",
  "documentTaxonValidations": [
    {
      "taxonPath": "<string>",
      "taxonomyRef": "<string>",
      "validation": {
        "conditional": true,
        "conditionalFormula": "<string>",
        "description": "<string>",
        "detailFormula": "<string>",
        "disabled": true,
        "exceptionId": "<string>",
        "messageFormula": "<string>",
        "name": "<string>",
        "overridable": true,
        "ruleFormula": "<string>",
        "supportArticleId": "<string>"
      }
    }
  ],
  "executionTargets": {
    "instances": [
      {
        "actor": {
          "actorId": "<string>",
          "actorType": "<string>"
        },
        "contentObjectId": "<string>",
        "documentFamilyId": "<string>",
        "labelsToApply": [
          "<string>"
        ],
        "ref": "<string>",
        "taxonomyRefs": [
          "<string>"
        ],
        "type": "<string>"
      }
    ]
  },
  "id": "b1234567-89ab-cdef-0123-456789abcdef",
  "locked": true,
  "metadata": {},
  "metadataSource": {},
  "modified": "2023-11-07T05:31:56Z",
  "originalPath": "<string>",
  "path": "invoices/2025/q4/invoice-001.pdf",
  "pendingProcessing": true,
  "size": 245760,
  "storeRef": "<string>",
  "summary": "<string>",
  "updatedOn": "2023-11-07T05:31:56Z",
  "uuid": "<string>"
}

Authorizations

​
x-api-key
string
header
required

API key for authentication. Create one from the Kodexa platform UI under Settings > Access Tokens.

Path Parameters

​
id
string<uuid>
required

Unique identifier (UUID) of the resource.

Query Parameters

​
path
string

File path within the store. Defaults to the uploaded filename.

​
metadata
string

JSON string of key-value metadata to attach to the document family.

​
documentVersion
string

Optional document version string.

Body

multipart/form-data
​
file
file
required

File to upload

Response

Created document family

A document family groups related content objects representing a single logical document, tracking its processing lifecycle.

​
changeSequence
integer<int32>

Optimistic locking version number.

​
contentObjects
object[]

Content objects belonging to this document family, ordered by index.

​
created
string<date-time> | null

Original file creation date.

​
createdOn
string<date-time>

Timestamp when the document family was created.

​
deleteUserEmail
string | null

Email of the user who deleted the document family.

​
deleted
boolean

Whether the document family has been soft-deleted.

​
deletedDate
string<date-time> | null

Timestamp when the document family was soft-deleted.

​
documentStatus
string

Current processing status of the document.

​
documentTaxonValidations
object[]

Validation results against the document taxonomy.

​
executionTargets
object

Processing execution targets for this document.

​
id
string

Unique identifier (UUID) for the document family.

Example:

"b1234567-89ab-cdef-0123-456789abcdef"

​
locked
boolean

Whether the document family is locked for processing.

​
metadata
object

Document metadata extracted during processing.

​
metadataSource
object

Maps metadata keys to their source content object IDs.

​
modified
string<date-time> | null

Original file modification date.

​
originalPath
string | null

Original path before soft-deletion or rename.

​
path
string

File path or name of the document.

Example:

"invoices/2025/q4/invoice-001.pdf"

​
pendingProcessing
boolean

Whether the document family is queued for processing.

​
size
integer<int64>

File size in bytes.

Example:

245760

​
storeRef
string

Reference to the document store containing this document family.

​
summary
string

AI-generated summary of the document content.

​
updatedOn
string<date-time>

Timestamp when the document family was last updated.

​
uuid
string

Secondary UUID identifier.