Project ingest

Start or resume a project object upload

Tenant-scoped resumable project ingest. SHA-256 hashes are lowercase hex. Chunks use a raw octet stream; status lists received and missing indexes. Completed originals trigger project.object.received.v1. The async job is polled through /api/jobs/:jobId/status.

post/api/project-upload/start

Request

  • Base URL: https://api.cernion.de
  • URL: https://api.cernion.de/api/project-upload/start
  • Auth: none declared

Query parameters

tokenstring

Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.

Request body

projectIdstring required
namestring required
sizeinteger required
hashstring required
mimeTypestring
sensitivityLevel'public' | 'tenant_internal' | 'restricted' | 'highly_sensitive'
requiredClearancestring[]
tokenstring

Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

Example request

{
  "projectId": "example-project",
  "name": "documents.zip",
  "size": 1024,
  "hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "mimeType": "application/zip",
  "sensitivityLevel": "tenant_internal",
  "requiredClearance": [],
  "chunks": [
    {
      "hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "size": 1024
    }
  ]
}

Response

Start or resume a project object upload

uploadIdstring
objectIdstring
chunkSizeinteger
status'receiving' | 'received' | 'failed' | 'extracted'
chunksobject[]
missinginteger[]

Changes

No recorded changes to this operation across all 2 revisions of this API.