Upload Attachment API

Upload files that can be referenced in Assistant conversations using their attachment IDs.

To use the API you need an API key. You can create API Keys in your Workspace settings: https://app.langdock.com/settings/workspace/products/api

cURL

cURL

curl --request POST \
  --url https://api.langdock.com/attachment/v1/upload \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'

Node (axios + form-data)

Request

This endpoint accepts multipart/form-data requests with a single file upload.

• Method: POST

• Path: /attachment/v1/upload

• Content-Type: multipart/form-data

Header

• Authorization (string, required) — API key as Bearer token. Format: "Bearer YOUR_API_KEY"

Body

• file (file, required) — The file to upload

Response

200 application/json — Successfully uploaded file

Response JSON:

response.json

{
  "attachmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "file": {
    "name": "<string>",
    "mimeType": "<string>",
    "sizeInBytes": 123
  }
}

Field details:

attachmentId

• Type: string (uuid)

• Required: yes

• Description: Unique identifier for the uploaded attachment

file

• Type: object

• Required: yes

Child attributes:

• file.name — string, required — Original filename

• file.mimeType — string, required — MIME type of the file

• file.sizeInBytes — integer, required — Size of the file in bytes

Example usage

• Use the returned attachmentId in the Assistant API by including it in the attachmentIds array at the assistant level or message level.

Error handling

Example (Node.js)

error-handling.js

try {
  const response = await axios.post('https://api.langdock.com/attachment/v1/upload', ...);
} catch (error) {
  if (error.response) {
    switch (error.response.status) {
      case 400:
        console.error('No file provided');
        break;
      case 401:
        console.error('Invalid API key');
        break;
      case 500:
        console.error('Server error');
        break;
    }
  }
}

Possible status codes:

• 400 — No file provided

• 401 — Invalid API key

• 500 — Server error