Create Workspace
create_workspaceCreate a cloud workspace with durable files, saved revisions, conversation history, and an agent that runs messages, optionally using an existing agent.
Instructions
Create a Workspace: durable files with saved revisions, a main conversation and run history. Unless default_manager_agent_id is given, the call also creates the Workspace's agent, which runs the messages sent to the Workspace; that agent counts against the account's agent limit, and the Workspace counts against its Workspace limit. default_manager_agent_id selects an existing agent instead. Every Workspace has an agent; an agent that receives no messages does no work and costs nothing. The call returns after the Workspace's first revision exists. No run starts. idempotency_key identifies the request for 24 hours: the same key with the same arguments returns the same Workspace, and the same key with different arguments is refused with 422 idempotency_key_reused. Names are not unique: a new key with a used name creates a second Workspace. Task messages, the files the agent reads, and the agent's work are sent through OpenRouter to these model providers: OpenAI, DeepSeek and Anthropic. All three supply the agent's models, with Anthropic for advisor reviews and OpenAI for result reviews. TypeSafe receives short typed-judgment requests about the agent's steps. Runs started through this connector do not generate video. The provider list follows Plori's model catalog and can change.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"idempotency_key": "<idempotency_key>"
},
"name": "create_workspace"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | A display name for the Workspace. Names are not unique and do not identify the Workspace. | |
| account | No | Omit this field to create the Workspace in the caller's own account. To create it in an account that shares Workspaces with the caller, pass that account's account.user_id from list_workspaces, and only when the caller's role there is member; a viewer cannot create a Workspace in that account. | |
| idempotency_key | Yes | A string of 1-255 bytes you generate for this creation. The same key with the same arguments returns the same Workspace for 24 hours. | |
| default_manager_agent_id | No | The Workspace's agent, which runs messages sent to this Workspace: the UUID of an existing agent of the account. Omitted or empty, a new agent with the Workspace's name is created. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The Workspace UUID. | |
| name | Yes | The display name; not unique. | |
| role | Yes | The caller's role: owner, member or viewer. | |
| state | Yes | active, adopting (its files are moving to new storage; runs are refused until it is active again), deleting or deleted. | |
| account | Yes | The account that owns the Workspace, with its user_id and email. | |
| created_at | Yes | When the Workspace was created. | |
| updated_at | Yes | When it last changed. | |
| main_session_id | Yes | The main conversation id. | |
| current_revision | Yes | The saved revision of the Workspace's current files; read_workspace_file reads it by default. | |
| default_agent_id | Yes | The Workspace's agent: it runs the messages sent to this Workspace. Every Workspace has one; it is null only once the Workspace is deleting or deleted. | |
| storage_readiness | No | Present while the Workspace's storage is still starting: state, since, pending_reason, retryable. | |
| root_working_copy_id | Yes | ||
| default_manager_agent_id | Yes | The same value as default_agent_id. |