Assets
Space MCP tools in the Assets scope (assets). Reach these with a wks_live_ key over space-mcp or space-api.
Tools in the assets scope, callable over space-mcp (tools/call) or space-api (REST) with a wks_live_* key that grants assets.
add_asset_from_url
Scope: assets:write
Add a file/image/video/audio to this space's asset library by downloading it from a public http/https URL. Ideal for saving a generate_image / generate_media result into the library. Returns the re-hosted URL and asset id.
| Parameter | Type | Required | Description |
|---|---|---|---|
filename | string | yes | File name to store it under, including extension. |
source_url | string | yes | Public http/https URL to import the file from. |
mime_type | string | MIME type override. Auto-detected from the response/extension if omitted. | |
title | string | Display title. Defaults to the filename. | |
description | string |
create_character
Scope: assets:write
Create a reusable character asset (identity image + persona).
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | |
description | string | ||
identity_image_url | string | ||
reference_image_urls | string[] | ||
gender | string | ||
archetype | string | ||
voice_asset_id | string | ||
tags | string[] | ||
sheet | object | ||
metadata | object |
list_characters
Scope: assets:read
List reusable character assets (identity image + persona sheet) in this space.
list_document_assets
Scope: assets:read
List document/image assets available to this space (file_url, file_type, tags).
list_voice_assets
Scope: assets:read
List voice assets available to this space.
update_character
Scope: assets:write
Update a character asset by id.
| Parameter | Type | Required | Description |
|---|---|---|---|
character_id | string | yes | |
name | string | ||
description | string | ||
identity_image_url | string | ||
reference_image_urls | string[] | ||
gender | string | ||
archetype | string | ||
voice_asset_id | string | ||
tags | string[] | ||
status | string | ||
is_favorite | boolean | ||
sheet | object | ||
metadata | object |
upload_asset
Scope: assets:write
Upload a file, image, video, or audio into this space's asset library from inline base64. Returns the hosted URL and asset id. Use add_asset_from_url instead when you already have a URL (e.g. a generate_image result).
| Parameter | Type | Required | Description |
|---|---|---|---|
filename | string | yes | File name including extension, e.g. 'logo.png'. |
data_base64 | string | yes | Base64-encoded file bytes (a data: URI prefix is also accepted). |
mime_type | string | MIME type, e.g. 'image/png'. Auto-detected from the extension if omitted. | |
title | string | Display title. Defaults to the filename. | |
description | string |