API ReferenceAssets

Create a new asset

Beta
Create a new asset such as a spreadsheet, document, folder, database, computer, or generic doc (admin-only) in your workspace with your current permissions. Computer assets return 202 after durable submission, which commits the asset and initialization delivery intent together. Runtime provisioning continues asynchronously. Inspect the returned asset ID for progress instead of repeating creation. In capability enforce mode, computer creation requires computer.create and returns 403 when denied.

Authentication

X-API-KEYstring
API Key authentication via header

Request

This endpoint expects an object.
asset_typeenumRequired

Type of asset to create. Supported types: ‘spreadsheet’ (or ‘sheet’), ‘document’ (or ‘doc’), ‘folder’, ‘database’ (or ‘db’), ‘computer’

parent_folder_idstring or nullOptional
ID of the parent folder to create the asset in
titlestring or nullOptional
Title for the new asset
workspace_idstring or nullOptional
ID of the workspace to create the asset in. If not provided, the asset is created in the user's current workspace. The user must be a member of the specified workspace.

Response

Asset created successfully
asset_idstring
ID of the newly created asset
asset_typestring
Type of the created asset
created_atstring
Timestamp when the asset was created
titlestring
Title of the created asset
parent_folder_idstring or nullOptional
ID of the parent folder
workspace_idstring or nullOptional
ID of the workspace that owns the created asset

Errors

400
Bad Request Error
403
Forbidden Error
422
Unprocessable Entity Error
500
Internal Server Error
503
Service Unavailable Error