Skip to main content
POST
/
api
/
v2
/
upload-session
Create an upload session
curl --request POST \
  --url https://paradigm.lighton.ai/api/v2/upload-session \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "ingestion_pipeline": "<any>"
}'
{
  "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_valid": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "documents": [
    {
      "id": 123,
      "title": "<string>",
      "collection": 123,
      "status": "pending",
      "updated_at": "2023-11-07T05:31:56Z",
      "workspace": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer token authentication

Body

Request serializer for creating a new upload session.

​
ingestion_pipeline
any

Optional ingestion pipeline to use for processing documents in this session

  • v1.0 - v1.0 : Fast & streamlined text parser
  • v2.1 - v2.1 : Enhanced table parser
  • v2.1.1 - v2.1.1 : Layout analysis/OCR and new chunker
  • v2.2 - v2.2 : Visual parser
  • v2.2.1 - v2.2.1 : Visual parser with new chunker
  • v3.0 - v3 : VLM, OCR and layout analysis

Response

Upload session created

Response serializer for upload session details.

​
uuid
string<uuid>
required

Unique identifier for the upload session

​
is_valid
boolean
required

Whether the upload session is currently valid and active

​
created_at
string<date-time>
required

Timestamp when the upload session was created

​
updated_at
string<date-time>
required

Timestamp when the upload session was last updated

​
documents
object[]
required

List of documents associated with this upload session

⌘I