Create a new File or Directory

Create a new File or Directory within a specified FileSet. If a file already exists at the specified path, it will attempt to overwrite it if the client has permission. If a Directory already exists at the specified path, it will return that Directory.

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

cURL

File Upload Request

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

200

Directory Exists Response

{
  "id": "22e1514a-354b-470f-bc32-c354812738f2",
  "path": "sample/directory/path",
  "name": "path",
  "size": null,
  "created": "2025-07-28T21:49:34.503Z",
  "createdBy": 27,
  "fileType": "DIRECTORY"
}

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

multipart/form-data

Represents a request to upload a file or create a directory.

file · file

The file to be uploaded. Leave null if creating a directory.

directoryPath · string

The directory path of the uploaded file, or the path of the created directory if no file is provided. Defaults to an empty string, i.e., the root directory, if not specified. Note: An empty string is not valid when intentionally creating a directory.

Response

200

application/json

Directory already created

Metadata for a directory within a file set.

id · string

path · string

name · string

size · integer

created · string<date-time>

createdBy · integer<int64>

fileType · enum<string>

Available options: AUDIO, VIDEO, IMAGE, TEXT, DOCUMENT, DIRECTORY, OTHER, UNKNOWN