Upload Files

Upload one or more files to your Karyam workspace.

POST/api/v1/workspaces/{workspace_uuid}/files/upload

Upload one or more files to a Karyam workspace.

This endpoint accepts multipart/form-data requests and supports uploading multiple files in a single request. Uploaded files can optionally be organized into folders using the prefix field.

*Required field

Headers

Header	Type	Description
`Authorization`*	`string`	Bearer token in the format Bearer <your_api_token>

Parameters

Parameter	Type	Description
`workspace_uuid`*	`string`	Unique identifier of the workspace.

Request Body

Field	Type	Description
`prefix`	`string`	Optional folder path where the uploaded files will be stored.
`files`*	`file[]`	One or more files to upload.

Response Status Codes

200Files uploaded successfully.

400Invalid request or missing files.

401Unauthorized. Invalid or missing API token.

curl -X POST \
  https://{your_domain}/api/v1/workspaces/{workspace_uuid}/files/upload \
  -H "Authorization: Bearer <your_api_token>" \
  -F "prefix=folder/" \
  -F "files=@/path/to/file.png" \
  -F "files=@/path/to/document.pdf"

Response 200JSON

{
  "meta": {
    "message": "Files uploaded successfully.",
    "status": "SUCCESS"
  },
  "result": {
    "uploaded": 2
  }
}