Initiate a split file upload.

Initiates a split file upload process for creating a new file within a FileSet.

POST /api/files/v1/filesets/{fileSetId}/files/multipart

Initiate a split file upload.

cURL

curl --request POST \
  --url https://{subdomain}.domo.com/api/files/v1/filesets/{fileSetId}/files/multipart \
  --header 'Content-Type: application/json' \
  --header 'X-DOMO-Developer-Token: <api-key>' \
  --data '
{
  "path": "<string>"
}
'

202

{
  "file": {
    "id": "df5fd883-e5cb-4cbb-a158-0e9ff1d37097",
    "path": "sample/directory/path/PaidTimeOffPolicy.pdf",
    "name": "PaidTimeOffPolicy.pdf",
    "fileType": "OTHER",
    "contentType": null,
    "size": null,
    "hash": null,
    "hashAlgorithm": "SHA_256_HEX",
    "downloadUrl": null,
    "created": "2025-08-25T16:05:56.676Z",
    "createdBy": 27,
    "connectorKey": null,
    "indexStatus": null,
    "indexReason": null
  },
  "status": "CREATED"
}

Authorizations

X-DOMO-Developer-Token · string · header · required

Path Parameters

fileSetId · string · required

The ID of the FileSet in which to create the File.

Body

application/json

The request object containing the details for the split file upload.

Represents a request to initiate a split file upload.

path · string

The full path destination for the file once the upload is finalized.

Response

202

application/json

Split file upload initiated successfully.

Represents the response after initiating a split file upload.

file · object

The file object containing the metadata known so far for the file to be uploaded.

Option 1

Option 2

Show child attributes

status · enum<string>

The status of the upload process.

Available options: CREATED, PROCESSING, SUCCESS, FAILED, UNKNOWN