API ReferenceAssets

Create a new asset

Beta

Create a new asset such as a spreadsheet, document, folder, database, or computer in your workspace. This endpoint uses internal GraphQL mutations to create assets with proper permissions and workspace integration. Computer assets return 202 after the initializing asset is committed; runtime provisioning continues asynchronously.

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