Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.deepmerge.ai/llms.txt

Use this file to discover all available pages before exploring further.

Action name: create_workspace · Can write or change saved notes
Create a workspace: an optional goal container inside this account. A workspace groups the entries for one distinct goal (a product, a client, a research topic, a launch) so retrieval can be scoped to it.

​
Inputs

FieldTypeRequiredWhat it is
namestringYesRequired. Human-readable name of the goal, e.g. “Pricing research”.
descriptionstringNoOptional. One or two sentences on what this workspace is for.
REUSE AN EXISTING WORKSPACE when your task belongs to a goal already
listed in get_self's `workspaces`. Pass that workspace_id to
get_context / get_entries / create_entry instead of making a new one.
CREATE A NEW WORKSPACE only when the user starts a genuinely distinct
goal that none of the existing workspaces cover.

Idempotent by name: if a workspace with this name already exists in the
account, it is returned as-is (`created: false`) instead of erroring, so a
fresh-context agent can call this without checking get_self first.

USE WHEN: the user kicks off a new, distinct workstream worth grouping.
DO NOT USE: for every task; to separate two agents on the same goal; to
isolate data for access control (there is none in V1).

Returns { workspace, created }. `created` is false when an existing
workspace was reused.