Connections

Create direct‐upload connection

Accepts multipart form data to configure a direct‐upload connection for the authenticated user. - If `wait=true`, files are processed immediately before returning. - Otherwise, files are queued for later processing.

POST
/api/upload

Authorization

AuthorizationRequiredBearer <token>

Bearer token authentication required

In: header

Request Body

multipart/form-dataRequired
linksarray<string>

Array of file URLs to import

filesRequiredarray<file>

Array of files to upload

metadatastring

JSON string of arbitrary metadata (e.g. {"name":"invoice"})

Query Parameters

waitstring

Whether to wait for processing to complete (true) or queue for later (false, default)

Default: "false"Value in: "true" | "false"
curl -X POST "https://app.dcup.dev/api/upload?wait=true" \
  -H "Authorization: Bearer <token>" \
  -F links="[\n  \"https://example.com/file1.pdf\",\n  \"https://example.com/file2.pdf\"\n]" \
  -F files="[\n  \"string\"\n]" \
  -F metadata="{\"type\":\"report\"}"

Upload accepted

{
  "code": "ok",
  "message": "Your file was successfully uploaded and processed."
}

Previous

Self-Host Dcup

Next

Delete specific connection DELETE