Create a file
Create an empty workspace, folder, workbook, or report in Sigma.
### Usage notes
- Specify a **parentId** for a folder, workbook, or report to place it within another folder. Retrieve the ID to use as a **parentId** by calling the [/v2/files](https://help.sigmacomputing.com/reference/list-files) endpoint and reviewing the `id` field in the response for files with a `type` of `folder`.
- Specify an **ownerId** for a folder, workbook, or report to create it on behalf of another user. Retrieve the **memberId** by calling the [/v2/members](https://help.sigmacomputing.com/reference/list-members) endpoint.
### Usage scenarios
- **Project onboarding**: Start a new project by creating a workspace and folders to contain the workbooks for the project.
Authentication
AuthorizationBearer
OAuth authentication of the form <token>.
Request
The request body.
Workspace details
Workspace to create
OR
Folder details
Folder to create
OR
Workbook details
Workbook to create
OR
Report details
Report to create
Response
The response body.
id
urlId
name
type
parentId
parentUrlId
permission
path
badge
isArchived
createdBy
The identifier of the user who created this object.
updatedBy
The identifier of the user or process that last updated this object.
createdAt
When the object was created.
updatedAt
When the object was last updated.
description
ownerId
parentSourceUrlId
For a document deployed to a tenant organization, the urlId of the source document in the parent organization. Only present when the document was deployed from a parent organization. The source document can be a workbook, template, data model, dataset, or report.

