Skip to content

workspace.identity.set.v1

Customise workspace identity

Changes the name, colour, or icon of the workspace identified by invocation scope. Omitted fields stay unchanged. An empty name restores the folder name; automatic restores the derived colour; a symbol replaces any uploaded icon. Custom image data is base64 and is decoded, bounded, and normalized to a small PNG before it enters workspace state.

At a glance

Callable byagent, cli, plugin
Provided bydev.tenon.core

Input and output

Schema not reproduced here

workspace.identity.set.v1 is callable from a shell, but the Tenon this page was generated against (Tenon 0.1.0 (build 1, wire v3)) did not serve it — the catalog beside this site is newer than that build. Update Tenon and re-run the generator, or ask your own build directly:

sh
tenon-cli intent describe workspace.identity.set.v1

The definition itself is in CoreIntentCatalog.swift.

Call it

From a plugin — declare it in intents.uses first:

js
const result = await tenon.intents.send("workspace.identity.set.v1", {})
if (!result.ok) throw new Error(result.error.code)

From a shell:

sh
tenon-cli intent send workspace.identity.set.v1 --input '{}'

Ask your own build for this same contract with tenon-cli intent describe workspace.identity.set.v1.