Create a new asset | Athena | API Reference Docs

Create a new asset such as a spreadsheet, document, or folder in your workspace. This endpoint uses internal GraphQL mutations to create assets with proper permissions and workspace integration.

Authentication

X-API-KEYstring

API Key authentication via header

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

asset_typeenumRequired

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

Allowed values:

parent_folder_idstring or nullOptional

ID of the parent folder to create the asset in

titlestring or nullOptional

Title for the new asset

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 null

ID of the parent folder

1	curl -X POST http://localhost:8000/api/v0/assets/create \
2	-H "X-API-KEY: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"asset_type": "spreadsheet",
6	"parent_folder_id": "asset_folder_12345",
7	"title": "My New Spreadsheet"
8	}'

1	{
2	"asset_id": "asset_abc123-def456-ghi789",
3	"asset_type": "spreadsheet",
4	"created_at": "2024-01-15T10:30:00Z",
5	"title": "My New Spreadsheet",
6	"parent_folder_id": "asset_folder_12345"
7	}

Authentication

Request

Response

Errors