Upload workspace content

put/workspaces/@currentUser/items

Uploads a single file to create a new file or updates the content of an existing file. You can also upload and expand a ZIP file to a folder.

Optionally, an action status ID can be provided to monitor the completion status. To get the action status ID, first call batchUpdate with the action UPLOAD or UPLOAD_EXPAND, which returns the action status ID on the request header.

Request Samples

Response Samples

1{
2  "value": {
3    "version": 1,
4    "workspaceId": "ce211872-f840-4d41-bcb4-4974cb35840e",
5    "name": "sleep.sas",
6    "location": "/Org/project/programs",
7    "path": "/Org/project/programs/sleep.sas",
8    "type": "FILE",
9    "modifiedTimeStamp": "2023-12-13T15:39:09.907Z"
10  }
11}

Query Parameters

NameTypeRequiredDescription
expand
boolean
false

Determines whether the ZIP file on the request should be expanded when it is uploaded to the workspace folder. This parameter is ignored if the path is to a file.

path
string
true

The full path of the workspace item.

Request Body

NameTypeRequiredDescription
filename
string
false

The name of the file. Clients must specify the name of the file as form data in the request body.

file
string
false

The actual file content. The content must be listed in the format of standard form data in the request body. Only one file is permitted in a multipart request.

Responses

StatusMeaningDescription
200OK

Content was created or updated successfully.

Schema
400Bad Request

Bad Request

404Not Found

Not found - the parent folder could not be found.

Schema