Upload a file to create a source

POST /sources/upload

Api key

Body

This is the source body object

name string Required

The name of the source
collections array[string] Required

The collections to which this source belongs to
file string(binary) Required

The file to be uploaded

Responses

200

A source response to be returned
Hide response attributes Show response attributes object
- id string
- name string
- collections array[object]
  
  Hide collections attributes Show collections attributes array[object]
  
  id string
  
  name string
- status string
- created_at integer
400

Invalid Request body or missing required parameters
Hide response attributes Show response attributes object
- code string
  
  An error code specific to the error.
- message string
  
  A human-readable message providing more details about the error.
402

Insufficient Credits
Hide response attributes Show response attributes object
- code string
  
  An error code specific to the error.
- message string
  
  A human-readable message providing more details about the error.

POST /sources/upload

curl \
 -X POST https://api.hansei.app/public/v1/sources/upload \
 -H "X-API-KEY: $API_KEY" \
 -H "Content-Type: multipart/form-data" \
 -F 'value={"name":"Employee Handbook","collections":["col_X1p7UscyehUFc6O4","col_HIjpFiRemkbpHgUn"],"file":"\u003cFileBuffer\u003e"}'

Request example

{
  "value": {
    "name": "Employee Handbook",
    "collections": [
      "col_X1p7UscyehUFc6O4",
      "col_HIjpFiRemkbpHgUn"
    ],
    "file": "<FileBuffer>"
  }
}

Request examples

{
  "name": "string",
  "collections": [
    "string"
  ],
  "file": "@file"
}

Response examples (200)

{
  "value": {
    "id": "src_4uPeOYWyQ01C8Epg",
    "name": "Employee Onboarding",
    "collections": [
      {
        "id": "col_X1p7UscyehUFc6O4",
        "name": "Employee Onboarding"
      },
      {
        "id": "col_HIjpFiRemkbpHgUn",
        "name": "Customer Support"
      },
      "{...}",
      "{...}"
    ],
    "status": "pending",
    "created_at": 1697386660315
  }
}

Response examples (200)

{
  "id": "src_4uPeOYWyQ01C8Epg",
  "name": "Employee Onboarding",
  "collections": [
    {
      "id": "col_X1p7UscyehUFc6O4",
      "name": "Employee Onboarding"
    }
  ],
  "status": "pending",
  "created_at": 1697386660315
}

Response examples (400)

{
  "code": "string",
  "message": "string"
}

Response examples (400)

{
  "code": "string",
  "message": "string"
}

Response examples (402)

{
  "code": "string",
  "message": "string"
}

Response examples (402)

{
  "code": "string",
  "message": "string"
}