Bento is an MCP server published by io.github.dzhng, hosted at mcp.bento.ing. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 214 tools, including recording_operation_create, skill_list, agent_list, agent_roster_list, agent_create.
One subscription for every kind of AI: images, video, voice and more.
1,097 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Run a cloud recording operation using the unchanged recording envelope (maximum request 1 MiB). Read-only catalog operations require files:read; all others require files:write. Results above the requested inline budget use artifact.read leases.
| Parameter | Type | Description |
|---|---|---|
| params * | object | |
| operation * | string | |
| workspaceSlug * | string |
{
"name": "recording_operation_create",
"description": "Run a cloud recording operation using the unchanged recording envelope (maximum request 1 MiB). Read-only catalog operations require files:read; all others require files:write. Results above the requested inline budget use artifact.read leases.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"operation",
"params"
],
"properties": {
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"operation": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}List the skills available to a session working in a workspace folder
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "skill_list",
"description": "List the skills available to a session working in a workspace folder",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"cwd": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List workspace agents
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "agent_list",
"description": "List workspace agents",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"slug": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List the agents reachable from one agent session
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_roster_list",
"description": "List the agents reachable from one agent session",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Register a workspace folder as an agent, together with the apps it declares
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "agent_create",
"description": "Register a workspace folder as an agent, together with the apps it declares",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"path",
"slug"
],
"properties": {
"apps": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"slug",
"command",
"apiScopes"
],
"properties": {
"icon": {
"type": "string"
},
"name": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"path": {
"type": "string"
},
"port": {
"type": "integer",
"maximum": 65535,
"minimum": 1
},
"slug": {
"type": "string"
},
"command": {
"type": "string"
},
"apiScopes": {
"type": "array",
"items": {
"enum": [
"files:read",
"files:write",
"memory",
"sessions",
"agents",
"services",
"integrations",
"apps",
"share",
"publish",
"members"
],
"type": "string"
},
"maxItems": 64
},
"installCommand": {
"type": "string"
}
}
}
},
"icon": {
"type": "string"
},
"name": {
"type": "string",
"pattern": "^[^[\\]<>`\\p{Cc}]*$",
"maxLength": 32,
"minLength": 1
},
"path": {
"type": "string",
"minLength": 1
},
"slug": {
"type": "string"
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Rename the default agent (the drive root's own agent)
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "agent_default_update",
"description": "Rename the default agent (the drive root's own agent)",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {
"name": {
"type": "string",
"pattern": "^[^[\\]<>`\\p{Cc}]*$",
"maxLength": 32,
"minLength": 1
},
"pinned": {
"type": "boolean",
"description": "Applies to everyone"
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Update agent disabled state, onboarding, pin, or display metadata
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_update",
"description": "Update agent disabled state, onboarding, pin, or display metadata",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {
"icon": {
"type": "string"
},
"name": {
"type": "string",
"pattern": "^[^[\\]<>`\\p{Cc}]*$",
"maxLength": 32,
"minLength": 1
},
"pinned": {
"type": "boolean",
"description": "Applies to everyone"
},
"disabled": {
"type": "boolean"
},
"onboarded": {
"type": "boolean"
}
}
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Mark the session's agent onboarded from inside its onboarding conversation
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| sessionId * | string | |
| workspaceSlug * | string |
{
"name": "session_agent_update",
"description": "Mark the session's agent onboarded from inside its onboarding conversation",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"onboarded"
],
"properties": {
"onboarded": {
"type": "boolean"
}
},
"additionalProperties": false
},
"sessionId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Mark the calling app's own agent onboarded, addressed by the app's credential
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "app_agent_update",
"description": "Mark the calling app's own agent onboarded, addressed by the app's credential",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"onboarded"
],
"properties": {
"onboarded": {
"type": "boolean"
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Delete an agent and its folder, including nested agents and apps
| Parameter | Type | Description |
|---|---|---|
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_delete",
"description": "Delete an agent and its folder, including nested agents and apps",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug"
],
"properties": {
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Approve a pending CLI login as the signed-in user.
| Parameter | Type | Description |
|---|---|---|
| userCode * | string |
{
"name": "device_approve",
"description": "Approve a pending CLI login as the signed-in user.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"userCode"
],
"properties": {
"userCode": {
"type": "string",
"pattern": "^[A-Z2-9]{4}-[A-Z2-9]{4}$"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Inspect the authenticated user, workspace memberships, and granted scopes.
No parameters.
{
"name": "whoami",
"description": "Inspect the authenticated user, workspace memberships, and granted scopes.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read the signed-in user profile.
No parameters.
{
"name": "user_profile_get",
"description": "Read the signed-in user profile.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Update the signed-in user profile.
| Parameter | Type | Description |
|---|---|---|
| body * | object |
{
"name": "user_profile_update",
"description": "Update the signed-in user profile.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {
"lastName": {
"type": "string",
"maxLength": 100
},
"firstName": {
"type": "string",
"maxLength": 100
}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}List ordinary API keys without returning their secrets.
| Parameter | Type | Description |
|---|---|---|
| query | object |
{
"name": "user_api_key_list",
"description": "List ordinary API keys without returning their secrets.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Issue a human identity key and reveal its secret once.
| Parameter | Type | Description |
|---|---|---|
| body * | object |
{
"name": "user_api_key_create",
"description": "Issue a human identity key and reveal its secret once.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"expiresAt": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Revoke one ordinary API key owned by the signed-in user.
| Parameter | Type | Description |
|---|---|---|
| apiKeyId * | string |
{
"name": "user_api_key_revoke",
"description": "Revoke one ordinary API key owned by the signed-in user.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"apiKeyId"
],
"properties": {
"apiKeyId": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Register a non-secret sync machine for the signed-in user.
| Parameter | Type | Description |
|---|---|---|
| body * | object |
{
"name": "user_machine_create",
"description": "Register a non-secret sync machine for the signed-in user.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"name",
"syncthingDeviceId"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"syncthingDeviceId": {
"type": "string",
"pattern": "^[A-Z2-7]{7}(-[A-Z2-7]{7})*$"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}List the signed-in user’s sync machines with creation and last use.
| Parameter | Type | Description |
|---|---|---|
| query | object |
{
"name": "user_machine_list",
"description": "List the signed-in user’s sync machines with creation and last use.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Remove one sync machine and detach its workspace mirrors.
| Parameter | Type | Description |
|---|---|---|
| machineId * | string |
{
"name": "user_machine_delete",
"description": "Remove one sync machine and detach its workspace mirrors.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"machineId"
],
"properties": {
"machineId": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}List pending workspace invitations addressed to the signed-in user.
| Parameter | Type | Description |
|---|---|---|
| query | object |
{
"name": "user_invitation_list",
"description": "List pending workspace invitations addressed to the signed-in user.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Accept an invitation addressed to the signed-in user and return its workspace.
| Parameter | Type | Description |
|---|---|---|
| invitationId * | string |
{
"name": "user_invitation_accept",
"description": "Accept an invitation addressed to the signed-in user and return its workspace.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"invitationId"
],
"properties": {
"invitationId": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Submit anonymous product feedback; accepted asynchronously and rate limited.
| Parameter | Type | Description |
|---|---|---|
| body * | object |
{
"name": "feedback_create",
"description": "Submit anonymous product feedback; accepted asynchronously and rate limited.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"content"
],
"properties": {
"source": {
"type": "string",
"maxLength": 128
},
"content": {
"type": "string",
"minLength": 1
}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Register the calling sync device as a whole-drive mirror of a workspace
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "sync_machine_create",
"description": "Register the calling sync device as a whole-drive mirror of a workspace",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"machineId",
"syncthingDeviceId"
],
"properties": {
"machineId": {
"type": "string",
"minLength": 1
},
"syncthingDeviceId": {
"type": "string",
"pattern": "^[A-Z2-7]{7}(-[A-Z2-7]{7})*$"
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}List the devices mirroring a workspace
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "sync_machine_list",
"description": "List the devices mirroring a workspace",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Detach one device you own from a workspace mirror
| Parameter | Type | Description |
|---|---|---|
| machineId * | string | |
| workspaceSlug * | string |
{
"name": "sync_machine_delete",
"description": "Detach one device you own from a workspace mirror",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"machineId"
],
"properties": {
"machineId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Inspect the bounded live exported credential inventory without secrets
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| appSlug * | string | |
| workspaceSlug * | string |
{
"name": "app_credential_list",
"description": "Inspect the bounded live exported credential inventory without secrets",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"appSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"appSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Export an independent app credential once with an explicit expiration
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| appSlug * | string | |
| workspaceSlug * | string |
{
"name": "app_credential_create",
"description": "Export an independent app credential once with an explicit expiration",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"appSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"expiration"
],
"properties": {
"expiration": {
"anyOf": [
{
"type": "string",
"const": "never"
},
{
"type": "object",
"required": [
"seconds"
],
"properties": {
"seconds": {
"type": "integer",
"maximum": 9007199254740,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}
]
}
},
"additionalProperties": false
},
"appSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Revoke one exported app credential without replacing managed credentials
| Parameter | Type | Description |
|---|---|---|
| appSlug * | string | |
| credentialId * | string | |
| workspaceSlug * | string |
{
"name": "app_credential_revoke",
"description": "Revoke one exported app credential without replacing managed credentials",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"appSlug",
"credentialId"
],
"properties": {
"appSlug": {
"type": "string",
"minLength": 1
},
"credentialId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}List current app domains in a workspace
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "app_domain_list",
"description": "List current app domains in a workspace",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Inspect an app domain and its DNS instructions
| Parameter | Type | Description |
|---|---|---|
| appSlug * | string | |
| workspaceSlug * | string |
{
"name": "app_domain_get",
"description": "Inspect an app domain and its DNS instructions",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"appSlug"
],
"properties": {
"appSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Attach one custom hostname without changing app visibility
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| appSlug * | string | |
| workspaceSlug * | string |
{
"name": "app_domain_update",
"description": "Attach one custom hostname without changing app visibility",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"appSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"hostname"
],
"properties": {
"hostname": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"appSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Request a fresh domain check or retry exhausted removal
| Parameter | Type | Description |
|---|---|---|
| appSlug * | string | |
| workspaceSlug * | string |
{
"name": "app_domain_recheck",
"description": "Request a fresh domain check or retry exhausted removal",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"appSlug"
],
"properties": {
"appSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Stop serving a custom hostname and schedule provider cleanup
| Parameter | Type | Description |
|---|---|---|
| appSlug * | string | |
| workspaceSlug * | string |
{
"name": "app_domain_delete",
"description": "Stop serving a custom hostname and schedule provider cleanup",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"appSlug"
],
"properties": {
"appSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}List workspace apps, optionally filtered by exact id, the deepest app containing a cwd, or drive path
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "app_list",
"description": "List workspace apps, optionally filtered by exact id, the deepest app containing a cwd, or drive path",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1
},
"cwd": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 1024,
"minLength": 1
},
"path": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"scope": {
"enum": [
"subtree",
"children",
"self"
],
"type": "string"
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Open an app through a short-lived access grant, optionally returning to its validated host and path
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| appSlug * | string | |
| workspaceSlug * | string |
{
"name": "app_launch",
"description": "Open an app through a short-lived access grant, optionally returning to its validated host and path",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"appSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"host": {
"type": "string"
},
"path": {
"type": "string"
}
},
"additionalProperties": false
},
"appSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Register a workspace folder as an app runtime with optional display metadata
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "app_create",
"description": "Register a workspace folder as an app runtime with optional display metadata",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"path",
"command",
"apiScopes",
"slug"
],
"properties": {
"icon": {
"type": "string"
},
"name": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"path": {
"type": "string",
"minLength": 1
},
"port": {
"type": "integer",
"maximum": 65535,
"minimum": 1
},
"slug": {
"type": "string"
},
"command": {
"type": "string"
},
"apiScopes": {
"type": "array",
"items": {
"enum": [
"files:read",
"files:write",
"memory",
"sessions",
"agents",
"services",
"integrations",
"apps",
"share",
"publish",
"members"
],
"type": "string"
},
"maxItems": 64
},
"installCommand": {
"type": "string"
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Get one registered app by slug
| Parameter | Type | Description |
|---|---|---|
| appSlug * | string | |
| workspaceSlug * | string |
{
"name": "app_get",
"description": "Get one registered app by slug",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"appSlug"
],
"properties": {
"appSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Update app disabled state, visibility, display metadata, or runtime settings
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| appSlug * | string | |
| workspaceSlug * | string |
{
"name": "app_update",
"description": "Update app disabled state, visibility, display metadata, or runtime settings",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"appSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {
"icon": {
"type": "string"
},
"name": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"port": {
"type": "integer",
"maximum": 65535,
"minimum": 1
},
"slug": {
"not": {}
},
"command": {
"type": "string"
},
"disabled": {
"type": "boolean"
},
"apiScopes": {
"type": "array",
"items": {
"enum": [
"files:read",
"files:write",
"memory",
"sessions",
"agents",
"services",
"integrations",
"apps",
"share",
"publish",
"members"
],
"type": "string"
},
"maxItems": 64
},
"visibility": {
"enum": [
"folder",
"public"
],
"type": "string"
},
"installCommand": {
"type": "string"
}
}
},
"appSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Stop and start an app with its current runtime, answering once it is ready or failed to come back
| Parameter | Type | Description |
|---|---|---|
| appSlug * | string | |
| workspaceSlug * | string |
{
"name": "app_restart",
"description": "Stop and start an app with its current runtime, answering once it is ready or failed to come back",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"appSlug"
],
"properties": {
"appSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Repair a broken app anchor by slug after the automatic move rail cannot recover its folder
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| appSlug * | string | |
| workspaceSlug * | string |
{
"name": "app_reanchor",
"description": "Repair a broken app anchor by slug after the automatic move rail cannot recover its folder",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"appSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string"
}
}
},
"appSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Stop serving and unregister an app
| Parameter | Type | Description |
|---|---|---|
| appSlug * | string | |
| workspaceSlug * | string |
{
"name": "app_delete",
"description": "Stop serving and unregister an app",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"appSlug"
],
"properties": {
"appSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Start a durable workspace ZIP capture; returns 202 and replays the same request ID.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "backup_create",
"description": "Start a durable workspace ZIP capture; returns 202 and replays the same request ID.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"requestId"
],
"properties": {
"requestId": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Page retained workspace backups, newest first, without download grants.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "backup_list",
"description": "Page retained workspace backups, newest first, without download grants.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read durable capture status, counters, and warning summary.
| Parameter | Type | Description |
|---|---|---|
| backupId * | string | |
| workspaceSlug * | string |
{
"name": "backup_get",
"description": "Read durable capture status, counters, and warning summary.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"backupId"
],
"properties": {
"backupId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Mint a fresh short-lived private download URL for a ready backup.
| Parameter | Type | Description |
|---|---|---|
| backupId * | string | |
| workspaceSlug * | string |
{
"name": "backup_download",
"description": "Mint a fresh short-lived private download URL for a ready backup.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"backupId"
],
"properties": {
"backupId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Cancel capture and delete its artifact; returns 202 while cleanup is pending.
| Parameter | Type | Description |
|---|---|---|
| backupId * | string | |
| workspaceSlug * | string |
{
"name": "backup_delete",
"description": "Cancel capture and delete its artifact; returns 202 while cleanup is pending.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"backupId"
],
"properties": {
"backupId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Read the saved account pin, active Drive choices and live backup status.
| Parameter | Type | Description |
|---|---|---|
| cloudBackupId * | string | |
| workspaceSlug * | string |
{
"name": "cloud_backup_get",
"description": "Read the saved account pin, active Drive choices and live backup status.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"cloudBackupId"
],
"properties": {
"cloudBackupId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Set the cloud backup target using an explicit, saved or sole active Drive account.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| cloudBackupId * | string | |
| workspaceSlug * | string |
{
"name": "cloud_backup_update",
"description": "Set the cloud backup target using an explicit, saved or sole active Drive account.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"cloudBackupId",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"enabled",
"sourcePath",
"remote"
],
"properties": {
"remote": {
"oneOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "default"
}
}
},
{
"type": "object",
"required": [
"kind",
"folderId"
],
"properties": {
"kind": {
"type": "string",
"const": "existing"
},
"folderId": {
"type": "string",
"minLength": 1
}
}
}
]
},
"enabled": {
"type": "boolean"
},
"sourcePath": {
"type": "string"
},
"connectionId": {
"type": "string",
"minLength": 1
}
}
},
"cloudBackupId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}List folders in the explicit, saved or sole active Drive account.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| cloudBackupId * | string | |
| workspaceSlug * | string |
{
"name": "cloud_backup_folder_list",
"description": "List folders in the explicit, saved or sole active Drive account.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"cloudBackupId"
],
"properties": {
"query": {
"type": "object",
"properties": {
"cursor": {
"type": "string",
"minLength": 1
},
"parent": {
"type": "string",
"minLength": 1
},
"connectionId": {
"type": "string",
"minLength": 1
}
}
},
"cloudBackupId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read failed cloud backup files from the live gateway.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| cloudBackupId * | string | |
| workspaceSlug * | string |
{
"name": "cloud_backup_failure_list",
"description": "Read failed cloud backup files from the live gateway.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"cloudBackupId"
],
"properties": {
"query": {
"type": "object",
"properties": {
"cursor": {
"type": "string"
}
}
},
"cloudBackupId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List the workspace credit ledger newest-first with actor attribution.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "billing_ledger_list",
"description": "List the workspace credit ledger newest-first with actor attribution.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read recent billing ledger entries across funded workspaces.
| Parameter | Type | Description |
|---|---|---|
| query | object |
{
"name": "user_billing_history_list",
"description": "Read recent billing ledger entries across funded workspaces.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read the payer account and every workspace it funds. Answers a user API key as well as the dashboard.
No parameters.
{
"name": "user_billing_get",
"description": "Read the payer account and every workspace it funds. Answers a user API key as well as the dashboard.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Update the signed-in payer top-up and account-limit settings.
| Parameter | Type | Description |
|---|---|---|
| body * | object |
{
"name": "user_billing_update",
"description": "Update the signed-in payer top-up and account-limit settings.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"workspaceSlug"
],
"properties": {
"workspaceSlug": {
"type": "string"
},
"autoTopupEnabled": {
"type": "boolean"
},
"autoTopupAmountMicroUsd": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 5000000
},
"maxMonthlySpendMicroUsd": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
},
"autoTopupThresholdMicroUsd": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 5000000
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Create a Stripe-hosted setup or credit top-up Checkout session.
| Parameter | Type | Description |
|---|---|---|
| body * | object |
{
"name": "user_billing_checkout",
"description": "Create a Stripe-hosted setup or credit top-up Checkout session.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"workspaceSlug"
],
"properties": {
"workspaceSlug": {
"type": "string"
},
"amountMicroUsd": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 5000000
}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Create a Stripe-hosted Customer Portal session.
| Parameter | Type | Description |
|---|---|---|
| body * | object |
{
"name": "user_billing_portal",
"description": "Create a Stripe-hosted Customer Portal session.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"workspaceSlug"
],
"properties": {
"workspaceSlug": {
"type": "string"
}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Create a Stripe-hosted Checkout session for a server-resolved subscription plan. Answers a user API key.
| Parameter | Type | Description |
|---|---|---|
| body * | object |
{
"name": "user_billing_subscription_checkout",
"description": "Create a Stripe-hosted Checkout session for a server-resolved subscription plan. Answers a user API key.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"workspaceSlug",
"plan"
],
"properties": {
"plan": {
"enum": [
"starter",
"pro",
"max"
],
"type": "string"
},
"workspaceSlug": {
"type": "string"
}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Upgrade, schedule a downgrade, or cancel the payer subscription. Answers a user API key.
| Parameter | Type | Description |
|---|---|---|
| body * | any |
{
"name": "user_billing_subscription_plan_update",
"description": "Upgrade, schedule a downgrade, or cancel the payer subscription. Answers a user API key.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"body"
],
"properties": {
"body": {
"anyOf": [
{
"type": "object",
"required": [
"workspaceSlug",
"plan"
],
"properties": {
"plan": {
"enum": [
"starter",
"pro",
"max"
],
"type": "string"
},
"workspaceSlug": {
"type": "string"
}
}
},
{
"type": "object",
"required": [
"workspaceSlug",
"cancel"
],
"properties": {
"cancel": {
"type": "boolean",
"const": true
},
"workspaceSlug": {
"type": "string"
}
}
},
{
"type": "object",
"required": [
"workspaceSlug",
"resume"
],
"properties": {
"resume": {
"type": "boolean",
"const": true
},
"workspaceSlug": {
"type": "string"
}
}
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Start or resume the onboarding card verification authorization.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "onboarding_payment_method_intent_create",
"description": "Start or resume the onboarding card verification authorization.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"attemptId"
],
"properties": {
"attemptId": {
"type": "string",
"maxLength": 200,
"minLength": 8
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Verify, release, and save the onboarding payment method.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "onboarding_payment_method_complete",
"description": "Verify, release, and save the onboarding payment method.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"attemptId",
"paymentIntentId",
"billingDetails"
],
"properties": {
"attemptId": {
"type": "string",
"maxLength": 200,
"minLength": 8
},
"billingDetails": {
"type": "object",
"required": [
"name",
"email",
"address"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"address": {
"type": "object",
"required": [
"line1",
"city",
"postalCode",
"country"
],
"properties": {
"city": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"line1": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"line2": {
"type": "string",
"maxLength": 200
},
"state": {
"type": "string",
"maxLength": 100
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"postalCode": {
"type": "string",
"maxLength": 30,
"minLength": 1
}
}
}
}
},
"paymentIntentId": {
"type": "string",
"minLength": 1
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Read server-derived onboarding payment readiness and retry state.
| Parameter | Type | Description |
|---|---|---|
| workspaceSlug * | string |
{
"name": "onboarding_payment_method_get",
"description": "Read server-derived onboarding payment readiness and retry state.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read workspace provider status, refreshing from the VM when reachable.
| Parameter | Type | Description |
|---|---|---|
| workspaceSlug * | string |
{
"name": "provider_list",
"description": "Read workspace provider status, refreshing from the VM when reachable.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Start a workspace provider device authorization; poll the returned session.
| Parameter | Type | Description |
|---|---|---|
| providerId * | string | |
| workspaceSlug * | string |
{
"name": "provider_connect",
"description": "Start a workspace provider device authorization; poll the returned session.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"providerId"
],
"properties": {
"providerId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Observe the code, pending, connected, or failed state of provider authorization.
| Parameter | Type | Description |
|---|---|---|
| connectionId * | string | |
| workspaceSlug * | string |
{
"name": "provider_connection_get",
"description": "Observe the code, pending, connected, or failed state of provider authorization.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"connectionId"
],
"properties": {
"connectionId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Disconnect a workspace provider under the existing member ownership policy.
| Parameter | Type | Description |
|---|---|---|
| providerId * | string | |
| workspaceSlug * | string |
{
"name": "provider_delete",
"description": "Disconnect a workspace provider under the existing member ownership policy.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"providerId"
],
"properties": {
"providerId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Search and page through the provider-neutral integration catalog
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "integration_catalog_list",
"description": "Search and page through the provider-neutral integration catalog",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"q": {
"type": "string",
"maxLength": 200
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Begin an OAuth connection using server-derived tenant identity
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "integration_connect",
"description": "Begin an OAuth connection using server-derived tenant identity",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"integration",
"redirectTo"
],
"properties": {
"redirectTo": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"integration": {
"type": "string",
"minLength": 1
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}List workspace integration connections directly from the provider
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "integration_connection_list",
"description": "List workspace integration connections directly from the provider",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Idempotently disconnect one tenant-owned integration account
| Parameter | Type | Description |
|---|---|---|
| connectionId * | string | |
| workspaceSlug * | string |
{
"name": "integration_connection_delete",
"description": "Idempotently disconnect one tenant-owned integration account",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"connectionId"
],
"properties": {
"connectionId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Set or clear the agents that receive one integration toolkit
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string | |
| integrationSlug * | string |
{
"name": "integration_agent_policy_update",
"description": "Set or clear the agents that receive one integration toolkit",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"integrationSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {
"allowedAgentIds": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 51
}
}
},
"workspaceSlug": {
"type": "string"
},
"integrationSlug": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Execute a provider tool using an explicit or sole active workspace account; return the raw provider response.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| toolSlug * | string |
{
"name": "integration_tool_execute",
"description": "Execute a provider tool using an explicit or sole active workspace account; return the raw provider response.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"toolSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {
"arguments": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"workspace": {
"type": "string"
},
"connectedAccountId": {
"type": "string",
"minLength": 1
}
}
},
"toolSlug": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Dry-run a remote MCP server for its tool count, per-turn cost, and auth requirement
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "mcp_server_probe",
"description": "Dry-run a remote MCP server for its tool count, per-turn cost, and auth requirement",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"auth": {
"oneOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "none"
}
}
},
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "oauth"
}
}
},
{
"type": "object",
"required": [
"kind",
"token"
],
"properties": {
"kind": {
"type": "string",
"const": "static"
},
"token": {
"type": "string",
"maxLength": 8192,
"minLength": 1
}
}
}
]
},
"name": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,48}$"
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Attach a remote MCP server to the workspace after a successful probe
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "mcp_server_create",
"description": "Attach a remote MCP server to the workspace after a successful probe",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"auth": {
"oneOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "none"
}
}
},
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "oauth"
}
}
},
{
"type": "object",
"required": [
"kind",
"token"
],
"properties": {
"kind": {
"type": "string",
"const": "static"
},
"token": {
"type": "string",
"maxLength": 8192,
"minLength": 1
}
}
}
]
},
"name": {
"type": "string",
"pattern": "^[a-zA-Z0-9_-]{1,48}$"
},
"label": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}List the workspace’s custom MCP servers with their health and per-agent scoping
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "mcp_server_list",
"description": "List the workspace’s custom MCP servers with their health and per-agent scoping",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Begin OAuth consent for an attached remote MCP server; open the returned authorization URL.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| name * | string | |
| workspaceSlug * | string |
{
"name": "mcp_server_connect",
"description": "Begin OAuth consent for an attached remote MCP server; open the returned authorization URL.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"name",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {
"redirectTo": {
"type": "string",
"maxLength": 2048
}
}
},
"name": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Idempotently detach one custom MCP server and its stored credential
| Parameter | Type | Description |
|---|---|---|
| name * | string | |
| workspaceSlug * | string |
{
"name": "mcp_server_delete",
"description": "Idempotently detach one custom MCP server and its stored credential",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Set or clear the agents that receive one custom MCP server
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| name * | string | |
| workspaceSlug * | string |
{
"name": "mcp_server_agent_policy_update",
"description": "Set or clear the agents that receive one custom MCP server",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"name",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {
"allowedAgentIds": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 51
}
}
},
"name": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Mint a short-lived, origin-bound viewer URL for the shared workspace desktop.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "desktop_viewer_grant_create",
"description": "Mint a short-lived, origin-bound viewer URL for the shared workspace desktop.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"embedOrigin"
],
"properties": {
"embedOrigin": {
"type": "string"
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Read the shared desktop lifecycle, viewer count, and browser-owner activity.
| Parameter | Type | Description |
|---|---|---|
| workspaceSlug * | string |
{
"name": "desktop_status_get",
"description": "Read the shared desktop lifecycle, viewer count, and browser-owner activity.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Focus an existing root or named-agent browser window without creating one.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_desktop_focus",
"description": "Focus an existing root or named-agent browser window without creating one.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"requestId"
],
"properties": {
"requestId": {
"type": "string",
"maxLength": 128,
"minLength": 1
}
},
"additionalProperties": false
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Read one chunk of the workspace drive snapshot; drive grants are refused
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "drive_get",
"description": "Read one chunk of the workspace drive snapshot; drive grants are refused",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List path anchors and their current health.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "anchor_list",
"description": "List path anchors and their current health.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Repair a broken anchor after its workspace path moves.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| anchorId * | string | |
| workspaceSlug * | string |
{
"name": "anchor_reanchor",
"description": "Repair a broken anchor after its workspace path moves.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"anchorId",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string"
}
}
},
"anchorId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}List one workspace directory with file stats
| Parameter | Type | Description |
|---|---|---|
| path * | string | |
| query | object | |
| workspaceSlug * | string |
{
"name": "file_list",
"description": "List one workspace directory with file stats",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"path"
],
"properties": {
"path": {
"type": "string"
},
"query": {
"type": "object",
"required": [
"list"
],
"properties": {
"list": {
"type": "string",
"const": "1"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
},
"optional": {
"type": "string",
"const": "1",
"description": "Answer a missing path with an empty 204 instead of 404."
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Search a folder and everything below it by name, path and document text. Results come from an index on the workspace VM, so they can lag the drive; meta.index says how far behind it is. Paths with any segment starting with "." and derived folders such as node_modules are never indexed, so no result does not mean no file. Terms of two letters or more match by word prefix; a one-letter term matches that whole word only. "voice" does not find "invoice". Text is read only from pdf, docx, pptx, xlsx, md, txt, csv and html files.
| Parameter | Type | Description |
|---|---|---|
| path * | string | |
| query | object | |
| workspaceSlug * | string |
{
"name": "file_search",
"description": "Search a folder and everything below it by name, path and document text. Results come from an index on the workspace VM, so they can lag the drive; meta.index says how far behind it is. Paths with any segment starting with \".\" and derived folders such as node_modules are never indexed, so no result does not mean no file. Terms of two letters or more match by word prefix; a one-letter term matches that whole word only. \"voice\" does not find \"invoice\". Text is read only from pdf, docx, pptx, xlsx, md, txt, csv and html files.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"path"
],
"properties": {
"path": {
"type": "string"
},
"query": {
"type": "object",
"required": [
"search"
],
"properties": {
"ext": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9]{1,16}$"
},
"maxItems": 32,
"description": "File extensions to keep, lowercase and without the dot (pdf, docx). Excludes folders."
},
"sort": {
"enum": [
"relevance",
"modified",
"name",
"size"
],
"type": "string",
"description": "Defaults to relevance for a query and modified for an empty one."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
},
"search": {
"type": "string",
"maxLength": 512,
"description": "Words to match by prefix. Empty lists the newest files first."
},
"modifiedAfter": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
},
"modifiedBefore": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read file or directory metadata without transferring file bytes
| Parameter | Type | Description |
|---|---|---|
| path * | string | |
| query | object | |
| workspaceSlug * | string |
{
"name": "file_stat",
"description": "Read file or directory metadata without transferring file bytes",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"path"
],
"properties": {
"path": {
"type": "string"
},
"query": {
"type": "object",
"properties": {
"optional": {
"type": "string",
"const": "1",
"description": "Answer a missing path with an empty 204 instead of 404."
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Render a model file as a turntable or still preview image
| Parameter | Type | Description |
|---|---|---|
| path * | string | |
| query | object | |
| workspaceSlug * | string |
{
"name": "file_preview",
"description": "Render a model file as a turntable or still preview image",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"path"
],
"properties": {
"path": {
"type": "string"
},
"query": {
"type": "object",
"required": [
"preview"
],
"properties": {
"preview": {
"enum": [
"turntable",
"still"
],
"type": "string"
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read drive usage and capacity, with recursive size for a subfolder
| Parameter | Type | Description |
|---|---|---|
| path * | string | |
| query | object | |
| workspaceSlug * | string |
{
"name": "file_usage",
"description": "Read drive usage and capacity, with recursive size for a subfolder",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"path"
],
"properties": {
"path": {
"type": "string"
},
"query": {
"type": "object",
"required": [
"usage"
],
"properties": {
"usage": {
"type": "string",
"const": "1"
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Stream one file with ETag and single-range support
| Parameter | Type | Description |
|---|---|---|
| path * | string | |
| query | object | |
| headers | object | |
| workspaceSlug * | string |
{
"name": "file_get",
"description": "Stream one file with ETag and single-range support",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"path"
],
"properties": {
"path": {
"type": "string"
},
"query": {
"type": "object",
"properties": {
"optional": {
"type": "string",
"const": "1",
"description": "Answer a missing path with an empty 204 instead of 404."
}
}
},
"headers": {
"type": "object",
"properties": {
"Range": {
"type": "string"
},
"If-None-Match": {
"type": "string"
},
"If-Modified-Since": {
"type": "string"
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Atomically write one file, optionally guarded by If-Match
| Parameter | Type | Description |
|---|---|---|
| body * | any | UTF-8 text or an object containing base64 bytes for a binary request body |
| path * | string | |
| headers | object | |
| workspaceSlug * | string |
{
"name": "file_update",
"description": "Atomically write one file, optionally guarded by If-Match",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"path",
"body"
],
"properties": {
"body": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"bytes"
],
"properties": {
"bytes": {
"type": "string",
"format": "base64",
"pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
"contentEncoding": "base64"
}
},
"additionalProperties": false
}
],
"description": "UTF-8 text or an object containing base64 bytes for a binary request body"
},
"path": {
"type": "string"
},
"headers": {
"type": "object",
"properties": {
"If-Match": {
"type": "string"
},
"Content-Type": {
"type": "string"
},
"If-None-Match": {
"type": "string"
},
"If-Unmodified-Since": {
"type": "string"
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Delete one file or empty directory
| Parameter | Type | Description |
|---|---|---|
| path * | string | |
| workspaceSlug * | string |
{
"name": "file_delete",
"description": "Delete one file or empty directory",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"path"
],
"properties": {
"path": {
"type": "string"
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Create a directory or symlink, move, copy, or bounded-recursively delete
| Parameter | Type | Description |
|---|---|---|
| body * | any | |
| workspaceSlug * | string |
{
"name": "file_action_create",
"description": "Create a directory or symlink, move, copy, or bounded-recursively delete",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"oneOf": [
{
"type": "object",
"required": [
"operation",
"path"
],
"properties": {
"path": {
"type": "string"
},
"operation": {
"type": "string",
"const": "mkdir"
},
"recursive": {
"type": "boolean",
"default": false
}
}
},
{
"type": "object",
"required": [
"operation",
"source",
"destination"
],
"properties": {
"source": {
"type": "string"
},
"operation": {
"type": "string",
"const": "move"
},
"overwrite": {
"type": "boolean",
"default": false
},
"destination": {
"type": "string"
}
}
},
{
"type": "object",
"required": [
"operation",
"source",
"destination"
],
"properties": {
"source": {
"type": "string"
},
"operation": {
"type": "string",
"const": "copy"
},
"overwrite": {
"type": "boolean",
"default": false
},
"recursive": {
"type": "boolean",
"default": false
},
"destination": {
"type": "string"
}
}
},
{
"type": "object",
"required": [
"operation",
"path"
],
"properties": {
"path": {
"type": "string"
},
"operation": {
"type": "string",
"const": "delete"
},
"recursive": {
"type": "boolean",
"default": false
}
}
},
{
"type": "object",
"required": [
"operation",
"path",
"target"
],
"properties": {
"path": {
"type": "string"
},
"target": {
"type": "string",
"maxLength": 4096,
"minLength": 1
},
"operation": {
"type": "string",
"const": "symlink"
}
}
}
]
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Create a short-lived, headerless reference to one workspace file
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "file_download_create",
"description": "Create a short-lived, headerless reference to one workspace file",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string"
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Create a short-lived direct upload session for one Drive path prefix
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "file_upload_create",
"description": "Create a short-lived direct upload session for one Drive path prefix",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"pathPrefix"
],
"properties": {
"pathPrefix": {
"type": "string"
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Page one file’s attributed event history in sequence order
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "file_activity_history_list",
"description": "Page one file’s attributed event history in sequence order",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"reads": {
"enum": [
"0",
"1"
],
"type": "string"
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List every actor that touched one file, most recently active first
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "file_activity_seen_by_list",
"description": "List every actor that touched one file, most recently active first",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Batch-resolve the most recent writer for each named entry of one directory
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "file_activity_latest_writer_list",
"description": "Batch-resolve the most recent writer for each named entry of one directory",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"required": [
"dir",
"path"
],
"properties": {
"dir": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string"
}
]
},
"path": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Page file events by workspace, exact path, or folder subtree in sequence order
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "file_activity_feed_list",
"description": "Page file events by workspace, exact path, or folder subtree in sequence order",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"default": "asc"
},
"reads": {
"enum": [
"0",
"1"
],
"type": "string"
},
"scope": {
"enum": [
"exact",
"subtree"
],
"type": "string"
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Browse listed marketplace agents.
| Parameter | Type | Description |
|---|---|---|
| query | object |
{
"name": "marketplace_list",
"description": "Browse listed marketplace agents.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "object",
"properties": {
"q": {
"type": "string",
"maxLength": 200
},
"tag": {
"enum": [
"sales",
"marketing",
"engineering",
"customer-support",
"operations",
"people",
"product",
"personal"
],
"type": "string"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
},
"availability": {
"enum": [
"available",
"unavailable"
],
"type": "string"
},
"verifiedPublisher": {
"enum": [
"true",
"false"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read a marketplace listing and its changelog.
| Parameter | Type | Description |
|---|---|---|
| agentSlug * | string | |
| publisherSlug * | string |
{
"name": "marketplace_publisher_agent_get",
"description": "Read a marketplace listing and its changelog.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"publisherSlug",
"agentSlug"
],
"properties": {
"agentSlug": {
"type": "string",
"minLength": 1
},
"publisherSlug": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Offer one of this workspace's agents on the marketplace.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "listing_create",
"description": "Offer one of this workspace's agents on the marketplace.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"agentSlug"
],
"properties": {
"title": {
"type": "string",
"minLength": 1
},
"summary": {
"type": "string",
"minLength": 1
},
"agentSlug": {
"type": "string"
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Remove a listing from the catalog; existing subscribers keep pulling.
| Parameter | Type | Description |
|---|---|---|
| listingId * | string | |
| workspaceSlug * | string |
{
"name": "listing_delete",
"description": "Remove a listing from the catalog; existing subscribers keep pulling.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"listingId"
],
"properties": {
"listingId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}List marketplace agent subscriptions for a workspace.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "marketplace_subscription_list",
"description": "List marketplace agent subscriptions for a workspace.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Install a marketplace listing and synchronously pull it.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "marketplace_subscription_create",
"description": "Install a marketplace listing and synchronously pull it.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"listingId"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[^[\\]<>`\\p{Cc}]*$",
"maxLength": 32,
"minLength": 1
},
"path": {
"type": "string"
},
"listingId": {
"type": "string",
"minLength": 1
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Clone a marketplace listing once into a caller-chosen path.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "marketplace_subscription_clone",
"description": "Clone a marketplace listing once into a caller-chosen path.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"listingId",
"path"
],
"properties": {
"path": {
"type": "string"
},
"listingId": {
"type": "string",
"minLength": 1
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Acknowledge the currently applied version of a subscription.
| Parameter | Type | Description |
|---|---|---|
| workspaceSlug * | string | |
| subscriptionId * | string |
{
"name": "marketplace_subscription_acknowledge",
"description": "Acknowledge the currently applied version of a subscription.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"subscriptionId"
],
"properties": {
"workspaceSlug": {
"type": "string"
},
"subscriptionId": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Detach a marketplace subscription while preserving local files.
| Parameter | Type | Description |
|---|---|---|
| workspaceSlug * | string | |
| subscriptionId * | string |
{
"name": "marketplace_subscription_delete",
"description": "Detach a marketplace subscription while preserving local files.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"subscriptionId"
],
"properties": {
"workspaceSlug": {
"type": "string"
},
"subscriptionId": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Complete one-time workspace onboarding; a campaign's starter agents install with it.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "onboarding_start",
"description": "Complete one-time workspace onboarding; a campaign's starter agents install with it.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"duetName"
],
"properties": {
"duetName": {
"type": "string",
"pattern": "^[^[\\]<>`\\p{Cc}]*$",
"maxLength": 32,
"minLength": 1
},
"examples": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"maxLength": 64
},
"maxItems": 3
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Search the catalog of third-party request APIs and funded resources.
| Parameter | Type | Description |
|---|---|---|
| query | object |
{
"name": "service_list",
"description": "Search the catalog of third-party request APIs and funded resources.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "object",
"properties": {
"q": {
"type": "string"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
},
"category": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read service mode, allowed methods/paths, billing, ownership and representations.
| Parameter | Type | Description |
|---|---|---|
| serviceId * | string |
{
"name": "service_get",
"description": "Read service mode, allowed methods/paths, billing, ownership and representations.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"serviceId"
],
"properties": {
"serviceId": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Observe an owned resource operation, recovery action, lease and settlement.
| Parameter | Type | Description |
|---|---|---|
| headers | object | |
| serviceId * | string | |
| operationId * | string | |
| workspaceSlug * | string |
{
"name": "service_operation_get",
"description": "Observe an owned resource operation, recovery action, lease and settlement.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"serviceId",
"operationId",
"workspaceSlug"
],
"properties": {
"headers": {
"type": "object",
"properties": {
"x-duet-workspace": {
"type": "string"
}
},
"additionalProperties": false
},
"serviceId": {
"type": "string",
"minLength": 1
},
"operationId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Create a session and wait for the submitted turn to finish
| Parameter | Type | Description |
|---|---|---|
| body * | any | |
| waitMs | integer | |
| background | boolean | |
| workspaceSlug * | string |
{
"name": "session_create",
"description": "Create a session and wait for the submitted turn to finish",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"anyOf": [
{
"type": "object",
"required": [
"prompt",
"clientRequestId"
],
"properties": {
"cwd": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 1024,
"minLength": 1
},
"mode": {
"type": "object",
"required": [
"name",
"prompt",
"states"
],
"properties": {
"name": {
"type": "string"
},
"prompt": {
"type": "string"
},
"states": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
}
},
"tier": {
"enum": [
"frontier",
"balanced",
"economy",
"openai-frontier",
"openai-max",
"anthropic-frontier",
"anthropic-max",
"anthropic-balanced",
"google-frontier",
"google-recommended",
"google-balanced"
],
"type": "string"
},
"agent": {
"type": "string",
"description": "The agent that owns the session, by slug; `root` is the workspace agent. The session runs in the agent's folder. Not with cwd."
},
"title": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"images": {
"type": "array",
"items": {
"type": "object",
"required": [
"data",
"mimeType"
],
"properties": {
"data": {
"type": "string",
"minLength": 1
},
"mimeType": {
"enum": [
"image/png",
"image/jpeg",
"image/webp",
"image/gif"
],
"type": "string"
}
}
},
"maxItems": 4
},
"prompt": {
"type": "string",
"description": "The words of the input. May be empty when it carries images or attachments."
},
"audience": {
"type": "object",
"required": [
"kind",
"memberUserIds"
],
"properties": {
"kind": {
"type": "string",
"const": "specific"
},
"memberUserIds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100
}
},
"additionalProperties": false
},
"behavior": {
"enum": [
"steer",
"follow_up"
],
"type": "string",
"default": "steer"
},
"dictated": {
"type": "boolean",
"description": "True when the words were transcribed from speech."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"name",
"bytes"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"path": {
"type": "string",
"minLength": 1
},
"bytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"mimeType": {
"type": "string",
"minLength": 1
}
}
},
"maxItems": 10
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"agentSlug"
],
"properties": {
"kind": {
"type": "string",
"const": "onboarding"
},
"agentSlug": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"waitMs": {
"type": "integer",
"maximum": 720000,
"minimum": 0
},
"background": {
"type": "boolean"
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Create a child session and wait for the submitted turn to finish
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| waitMs | integer | |
| sessionId * | string | |
| background | boolean | |
| workspaceSlug * | string |
{
"name": "session_child_create",
"description": "Create a child session and wait for the submitted turn to finish",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"prompt",
"clientRequestId"
],
"properties": {
"cwd": {
"type": "string",
"pattern": "^[^\\u0000-\\u001f\\u007f]+$",
"maxLength": 1024,
"minLength": 1
},
"mode": {
"type": "object",
"required": [
"name",
"prompt",
"states"
],
"properties": {
"name": {
"type": "string"
},
"prompt": {
"type": "string"
},
"states": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
}
},
"tier": {
"enum": [
"frontier",
"balanced",
"economy",
"openai-frontier",
"openai-max",
"anthropic-frontier",
"anthropic-max",
"anthropic-balanced",
"google-frontier",
"google-recommended",
"google-balanced"
],
"type": "string"
},
"agent": {
"type": "string",
"description": "The agent that owns the session, by slug; `root` is the workspace agent. The session runs in the agent's folder. Not with cwd."
},
"title": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"images": {
"type": "array",
"items": {
"type": "object",
"required": [
"data",
"mimeType"
],
"properties": {
"data": {
"type": "string",
"minLength": 1
},
"mimeType": {
"enum": [
"image/png",
"image/jpeg",
"image/webp",
"image/gif"
],
"type": "string"
}
}
},
"maxItems": 4
},
"prompt": {
"type": "string",
"description": "The words of the input. May be empty when it carries images or attachments."
},
"behavior": {
"enum": [
"steer",
"follow_up"
],
"type": "string",
"default": "steer"
},
"dictated": {
"type": "boolean",
"description": "True when the words were transcribed from speech."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"name",
"bytes"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"path": {
"type": "string",
"minLength": 1
},
"bytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"mimeType": {
"type": "string",
"minLength": 1
}
}
},
"maxItems": 10
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
},
"waitMs": {
"type": "integer",
"maximum": 720000,
"minimum": 0
},
"sessionId": {
"type": "string",
"minLength": 1
},
"background": {
"type": "boolean"
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Send a user message and wait for the submitted turn to finish
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| waitMs | integer | |
| sessionId * | string | |
| background | boolean | |
| workspaceSlug * | string |
{
"name": "session_message_create",
"description": "Send a user message and wait for the submitted turn to finish",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"prompt",
"clientRequestId"
],
"properties": {
"tier": {
"enum": [
"frontier",
"balanced",
"economy",
"openai-frontier",
"openai-max",
"anthropic-frontier",
"anthropic-max",
"anthropic-balanced",
"google-frontier",
"google-recommended",
"google-balanced"
],
"type": "string"
},
"images": {
"type": "array",
"items": {
"type": "object",
"required": [
"data",
"mimeType"
],
"properties": {
"data": {
"type": "string",
"minLength": 1
},
"mimeType": {
"enum": [
"image/png",
"image/jpeg",
"image/webp",
"image/gif"
],
"type": "string"
}
}
},
"maxItems": 4
},
"prompt": {
"type": "string",
"description": "The words of the input. May be empty when it carries images or attachments."
},
"behavior": {
"enum": [
"steer",
"follow_up"
],
"type": "string",
"default": "steer"
},
"dictated": {
"type": "boolean",
"description": "True when the words were transcribed from speech."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"name",
"bytes"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"path": {
"type": "string",
"minLength": 1
},
"bytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"mimeType": {
"type": "string",
"minLength": 1
}
}
},
"maxItems": 10
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"sourceSessionId": {
"type": "string",
"minLength": 1
}
}
},
"waitMs": {
"type": "integer",
"maximum": 720000,
"minimum": 0
},
"sessionId": {
"type": "string",
"minLength": 1
},
"background": {
"type": "boolean"
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Answer a session and wait for the submitted turn to finish
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| waitMs | integer | |
| sessionId * | string | |
| background | boolean | |
| workspaceSlug * | string |
{
"name": "session_answer",
"description": "Answer a session and wait for the submitted turn to finish",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"answer",
"clientRequestId"
],
"properties": {
"answer": {
"type": "string",
"description": "The words of the input. May be empty when it carries images or attachments."
},
"images": {
"type": "array",
"items": {
"type": "object",
"required": [
"data",
"mimeType"
],
"properties": {
"data": {
"type": "string",
"minLength": 1
},
"mimeType": {
"enum": [
"image/png",
"image/jpeg",
"image/webp",
"image/gif"
],
"type": "string"
}
}
},
"maxItems": 4
},
"dictated": {
"type": "boolean",
"description": "True when the words were transcribed from speech."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"name",
"bytes"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"path": {
"type": "string",
"minLength": 1
},
"bytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"mimeType": {
"type": "string",
"minLength": 1
}
}
},
"maxItems": 10
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"sourceSessionId": {
"type": "string",
"minLength": 1
}
}
},
"waitMs": {
"type": "integer",
"maximum": 720000,
"minimum": 0
},
"sessionId": {
"type": "string",
"minLength": 1
},
"background": {
"type": "boolean"
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Create or message an agent's default session and wait for the turn
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| waitMs | integer | |
| agentSlug * | string | |
| background | boolean | |
| workspaceSlug * | string |
{
"name": "agent_session_default_message_create",
"description": "Create or message an agent's default session and wait for the turn",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"prompt",
"clientRequestId"
],
"properties": {
"tier": {
"enum": [
"frontier",
"balanced",
"economy",
"openai-frontier",
"openai-max",
"anthropic-frontier",
"anthropic-max",
"anthropic-balanced",
"google-frontier",
"google-recommended",
"google-balanced"
],
"type": "string"
},
"images": {
"type": "array",
"items": {
"type": "object",
"required": [
"data",
"mimeType"
],
"properties": {
"data": {
"type": "string",
"minLength": 1
},
"mimeType": {
"enum": [
"image/png",
"image/jpeg",
"image/webp",
"image/gif"
],
"type": "string"
}
}
},
"maxItems": 4
},
"prompt": {
"type": "string",
"description": "The words of the input. May be empty when it carries images or attachments."
},
"behavior": {
"enum": [
"steer",
"follow_up"
],
"type": "string",
"default": "steer"
},
"dictated": {
"type": "boolean",
"description": "True when the words were transcribed from speech."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"name",
"bytes"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"path": {
"type": "string",
"minLength": 1
},
"bytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"mimeType": {
"type": "string",
"minLength": 1
}
}
},
"maxItems": 10
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"sourceSessionId": {
"type": "string",
"minLength": 1
},
"agentFirstMessage": {
"type": "string",
"maxLength": 2000
}
},
"additionalProperties": false
},
"waitMs": {
"type": "integer",
"maximum": 720000,
"minimum": 0
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"background": {
"type": "boolean"
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Read or wait for the durable outcome of an existing session input
| Parameter | Type | Description |
|---|---|---|
| seq * | integer | |
| waitMs | integer | |
| sessionId * | string | |
| workspaceSlug * | string |
{
"name": "session_result_get",
"description": "Read or wait for the durable outcome of an existing session input",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId",
"seq"
],
"properties": {
"seq": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"waitMs": {
"type": "integer",
"maximum": 720000,
"minimum": 0
},
"sessionId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Add context to a session without starting a turn
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| sessionId * | string | |
| workspaceSlug * | string |
{
"name": "session_note_create",
"description": "Add context to a session without starting a turn",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"note"
],
"properties": {
"note": {
"type": "string",
"maxLength": 16384,
"description": "The words of the input. May be empty when it carries images or attachments."
},
"images": {
"type": "array",
"items": {
"type": "object",
"required": [
"data",
"mimeType"
],
"properties": {
"data": {
"type": "string",
"minLength": 1
},
"mimeType": {
"enum": [
"image/png",
"image/jpeg",
"image/webp",
"image/gif"
],
"type": "string"
}
}
},
"maxItems": 4
},
"dictated": {
"type": "boolean",
"description": "True when the words were transcribed from speech."
},
"attachments": {
"type": "array",
"items": {
"type": "object",
"required": [
"path",
"name",
"bytes"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"path": {
"type": "string",
"minLength": 1
},
"bytes": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"mimeType": {
"type": "string",
"minLength": 1
}
}
},
"maxItems": 10
},
"clientRequestId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"sourceSessionId": {
"type": "string",
"minLength": 1
}
}
},
"sessionId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Interrupt a running session
| Parameter | Type | Description |
|---|---|---|
| sessionId * | string | |
| workspaceSlug * | string |
{
"name": "session_interrupt",
"description": "Interrupt a running session",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId"
],
"properties": {
"sessionId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Read one chunk of the workspace directory snapshot
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "directory_get",
"description": "Read one chunk of the workspace directory snapshot",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"cursor": {
"type": "string",
"minLength": 1
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List and page sessions by bucket. search keeps a session only when every word appears in its title or first prompt, so adding a word only narrows the results.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "session_list",
"description": "List and page sessions by bucket. search keeps a session only when every word appears in its title or first prompt, so adding a word only narrows the results.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"bucket": {
"enum": [
"asking",
"running",
"scheduled",
"done"
],
"type": "string"
},
"cursor": {
"type": "string",
"minLength": 1
},
"search": {
"type": "string",
"maxLength": 200
},
"agentId": {
"type": "string",
"minLength": 1
},
"archived": {
"enum": [
"exclude",
"only"
],
"type": "string",
"default": "exclude"
},
"topLevel": {
"anyOf": [
{
"type": "boolean",
"const": true
},
{
"type": "string",
"const": "true"
}
]
},
"excludeDefault": {
"anyOf": [
{
"type": "boolean",
"const": true
},
{
"type": "string",
"const": "true"
}
]
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Search the messages of every session you can see with a regular expression. Sessions come back best match first, each with its matching messages as snippets; open a match in context with session.history.list from its seq. The pattern is a JavaScript RegExp with the `u` flag, which differs from ripgrep: \w, \d and \b are ASCII-only, and there is no leading (?i). fixedStrings matches the pattern as plain text. Case follows smart case: case-insensitive unless the pattern spells an uppercase letter; caseSensitive overrides it. An index finds candidates by words, from the start of a word only, so the pattern must require a word that starts a word in the text: "ploy" does not find "deploy", and a pattern with no such word (\d{3}) is refused unless sessionId names one session to read whole. A word longer than 31 UTF-8 bytes is found by its first 31 bytes only, and near that cut a letter shorter lowercased than as written (the Kelvin sign, İ) can miss. Case-insensitive search finds a word by its lowercase spelling, so letters JavaScript treats as one (σ/ς, s/ſ, µ/μ) are different to the index. Long messages are indexed in chunks of about 8 KiB, and a match that spans two chunks can be missed. Only text a reader sees by default is searched: messages and the questions an agent asks, not tool calls, tool output, reasoning or attachments. meta.complete is false when a page may be missing matches, usually because a common word filled the read budget (reason read_budget); narrow the search as meta.hint says.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "session_search",
"description": "Search the messages of every session you can see with a regular expression. Sessions come back best match first, each with its matching messages as snippets; open a match in context with session.history.list from its seq. The pattern is a JavaScript RegExp with the `u` flag, which differs from ripgrep: \\w, \\d and \\b are ASCII-only, and there is no leading (?i). fixedStrings matches the pattern as plain text. Case follows smart case: case-insensitive unless the pattern spells an uppercase letter; caseSensitive overrides it. An index finds candidates by words, from the start of a word only, so the pattern must require a word that starts a word in the text: \"ploy\" does not find \"deploy\", and a pattern with no such word (\\d{3}) is refused unless sessionId names one session to read whole. A word longer than 31 UTF-8 bytes is found by its first 31 bytes only, and near that cut a letter shorter lowercased than as written (the Kelvin sign, İ) can miss. Case-insensitive search finds a word by its lowercase spelling, so letters JavaScript treats as one (σ/ς, s/ſ, µ/μ) are different to the index. Long messages are indexed in chunks of about 8 KiB, and a match that spans two chunks can be missed. Only text a reader sees by default is searched: messages and the questions an agent asks, not tool calls, tool output, reasoning or attachments. meta.complete is false when a page may be missing matches, usually because a common word filled the read budget (reason read_budget); narrow the search as meta.hint says.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"required": [
"pattern"
],
"properties": {
"from": {
"enum": [
"user",
"assistant"
],
"type": "string",
"description": "Only messages from this side."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
},
"agentId": {
"type": "string",
"minLength": 1,
"description": "Only sessions of this agent; `root` for the drive's own sessions."
},
"pattern": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "A JavaScript regular expression, compiled with the u flag; at most 1,000 characters."
},
"archived": {
"enum": [
"include",
"exclude",
"only"
],
"type": "string",
"default": "include",
"description": "Whether archived sessions are searched too, left out, or searched alone."
},
"sessionId": {
"type": "string",
"minLength": 1,
"description": "Only this session, read whole, so the pattern needs no required word."
},
"createdAfter": {
"type": "string",
"description": "Only messages created after this instant: an ISO date (midnight UTC) or date-time."
},
"fixedStrings": {
"type": "boolean",
"description": "Match the pattern as plain text, not a regex."
},
"caseSensitive": {
"type": "boolean",
"description": "Omitted: smart case, so the search is case-sensitive only when the pattern spells an uppercase letter."
},
"createdBefore": {
"type": "string",
"description": "Only messages created before this instant: an ISO date (midnight UTC) or date-time."
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Page one session’s direct children
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| sessionId * | string | |
| workspaceSlug * | string |
{
"name": "session_child_list",
"description": "Page one session’s direct children",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"bucket": {
"enum": [
"asking",
"running",
"scheduled",
"done"
],
"type": "string"
},
"cursor": {
"type": "string",
"minLength": 1
},
"archived": {
"enum": [
"exclude",
"only"
],
"type": "string",
"default": "exclude"
}
},
"additionalProperties": false
},
"sessionId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Get a session snapshot
| Parameter | Type | Description |
|---|---|---|
| sessionId * | string | |
| workspaceSlug * | string |
{
"name": "session_get",
"description": "Get a session snapshot",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId"
],
"properties": {
"sessionId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Get an agent's default session snapshot
| Parameter | Type | Description |
|---|---|---|
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_session_default_get",
"description": "Get an agent's default session snapshot",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug"
],
"properties": {
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Point an agent's default session alias at a session, or at nothing
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_session_default_update",
"description": "Point an agent's default session alias at a session, or at nothing",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"sessionId"
],
"properties": {
"sessionId": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "null"
}
]
}
}
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Page through an agent's default session history
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_session_default_history_list",
"description": "Page through an agent's default session history",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"view": {
"enum": [
"all",
"transcript"
],
"type": "string",
"default": "all"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"default": "desc"
},
"cursor": {
"type": "string",
"minLength": 1
},
"afterSeq": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Page the current members of a specific session audience
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| sessionId * | string | |
| workspaceSlug * | string |
{
"name": "session_audience_get",
"description": "Page the current members of a specific session audience",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"sessionId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Atomically update a specific session audience; self-removal returns no body when access is lost
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| sessionId * | string | |
| workspaceSlug * | string |
{
"name": "session_audience_update",
"description": "Atomically update a specific session audience; self-removal returns no body when access is lost",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {
"add": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100
},
"remove": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100
}
},
"additionalProperties": false
},
"sessionId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Page through durable session events
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| sessionId * | string | |
| workspaceSlug * | string |
{
"name": "session_history_list",
"description": "Page through durable session events",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId"
],
"properties": {
"query": {
"type": "object",
"properties": {
"view": {
"enum": [
"all",
"transcript"
],
"type": "string",
"default": "all"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"default": "desc"
},
"cursor": {
"type": "string",
"minLength": 1
},
"afterSeq": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"beforeSeq": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": false
},
"sessionId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read an image referenced by a session event.
| Parameter | Type | Description |
|---|---|---|
| imageId * | string | |
| sessionId * | string | |
| workspaceSlug * | string |
{
"name": "session_image_get",
"description": "Read an image referenced by a session event.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId",
"imageId"
],
"properties": {
"imageId": {
"type": "string",
"minLength": 1
},
"sessionId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Update session title, archive state, pin, read position, or the side-panel view it shows; personal archive and read position apply to you
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| sessionId * | string | |
| workspaceSlug * | string |
{
"name": "session_update",
"description": "Update session title, archive state, pin, read position, or the side-panel view it shows; personal archive and read position apply to you",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {
"view": {
"type": "string",
"maxLength": 1024,
"description": "The side-panel tab to show: apps/<slug>, files, files/<drive path>, lineage, desktop, or none"
},
"title": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"pinned": {
"type": "boolean",
"description": "Applies to everyone"
},
"readSeq": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Last event sequence read; applies to you"
},
"archived": {
"type": "boolean"
},
"archiveScope": {
"enum": [
"personal",
"global"
],
"type": "string",
"description": "Personal archive applies to you; global archive applies to everyone"
}
},
"additionalProperties": false
},
"sessionId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Idempotently accept permanent deletion of a session and every descendant
| Parameter | Type | Description |
|---|---|---|
| sessionId * | string | |
| workspaceSlug * | string |
{
"name": "session_delete",
"description": "Idempotently accept permanent deletion of a session and every descendant",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"sessionId"
],
"properties": {
"sessionId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}List incoming and outgoing shares for a workspace
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "share_list",
"description": "List incoming and outgoing shares for a workspace",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Offer a workspace path to an email address
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "share_create",
"description": "Offer a workspace path to an email address",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"path",
"toEmail",
"mode"
],
"properties": {
"mode": {
"enum": [
"read",
"write"
],
"type": "string"
},
"path": {
"type": "string"
},
"toEmail": {
"type": "string",
"maxLength": 320
},
"ignorePatterns": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 44
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Offer an incoming share onward without widening its access mode
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| shareId * | string | |
| workspaceSlug * | string |
{
"name": "share_reshare_create",
"description": "Offer an incoming share onward without widening its access mode",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"shareId",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"toEmail",
"mode"
],
"properties": {
"mode": {
"enum": [
"read",
"write"
],
"type": "string"
},
"toEmail": {
"type": "string",
"maxLength": 320
},
"ignorePatterns": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 44
}
}
},
"shareId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Accept an email-addressed share into a chosen workspace and mount path
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| token * | string |
{
"name": "share_request_accept",
"description": "Accept an email-addressed share into a chosen workspace and mount path",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"token",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"toWorkspaceId",
"mountPath"
],
"properties": {
"mountPath": {
"type": "string"
},
"toWorkspaceId": {
"type": "string",
"minLength": 1
}
}
},
"token": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}List pending share requests for the signed-in user email
| Parameter | Type | Description |
|---|---|---|
| query | object |
{
"name": "share_request_list",
"description": "List pending share requests for the signed-in user email",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Resolve a pending share token for the signed-in recipient
| Parameter | Type | Description |
|---|---|---|
| token * | string |
{
"name": "share_request_get",
"description": "Resolve a pending share token for the signed-in recipient",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"token"
],
"properties": {
"token": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Hide a pending share request for the signed-in recipient
| Parameter | Type | Description |
|---|---|---|
| token * | string |
{
"name": "share_request_decline",
"description": "Hide a pending share request for the signed-in recipient",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"token"
],
"properties": {
"token": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Pause or resume an active share on both participant workspaces
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| shareId * | string | |
| workspaceSlug * | string |
{
"name": "share_pause",
"description": "Pause or resume an active share on both participant workspaces",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"shareId",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"paused"
],
"properties": {
"paused": {
"type": "boolean"
}
}
},
"shareId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Unlink a received share while retaining its files and apps
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| shareId * | string | |
| workspaceSlug * | string |
{
"name": "share_unlink",
"description": "Unlink a received share while retaining its files and apps",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"shareId",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {}
},
"shareId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Revoke a share and every downstream reshare
| Parameter | Type | Description |
|---|---|---|
| shareId * | string | |
| workspaceSlug * | string |
{
"name": "share_delete",
"description": "Revoke a share and every downstream reshare",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"shareId"
],
"properties": {
"shareId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}List public file and folder addresses for a workspace
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "publish_list",
"description": "List public file and folder addresses for a workspace",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Publish a workspace file or folder at a public slug
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "publish_create",
"description": "Publish a workspace file or folder at a public slug",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"path"
],
"properties": {
"path": {
"type": "string",
"minLength": 1
},
"slug": {
"type": "string"
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Replace the public slug for a published path
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| publishSlug * | string | |
| workspaceSlug * | string |
{
"name": "publish_update",
"description": "Replace the public slug for a published path",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"publishSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string"
}
}
},
"publishSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Remove a public address without deleting its workspace content
| Parameter | Type | Description |
|---|---|---|
| publishSlug * | string | |
| workspaceSlug * | string |
{
"name": "publish_delete",
"description": "Remove a public address without deleting its workspace content",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"publishSlug"
],
"properties": {
"publishSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Freeze or resume a public publish
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| publishSlug * | string | |
| workspaceSlug * | string |
{
"name": "publish_pause",
"description": "Freeze or resume a public publish",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"publishSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"paused"
],
"properties": {
"paused": {
"type": "boolean"
}
}
},
"publishSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Mint short-lived credentials for direct uploads to the workspace VM
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "train_upload_session_create",
"description": "Mint short-lived credentials for direct uploads to the workspace VM",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}List files waiting in the workspace training inbox
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "train_upload_list",
"description": "List files waiting in the workspace training inbox",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Scrape a public URL into the workspace training inbox
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "train_upload_url_create",
"description": "Scrape a public URL into the workspace training inbox",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Remove one file from the workspace training inbox
| Parameter | Type | Description |
|---|---|---|
| path * | string | |
| workspaceSlug * | string |
{
"name": "train_upload_delete",
"description": "Remove one file from the workspace training inbox",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"path"
],
"properties": {
"path": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Snapshot staged sources and start an asynchronous training job
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "train_job_create",
"description": "Snapshot staged sources and start an asynchronous training job",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {
"urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 25
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"filename",
"content"
],
"properties": {
"content": {
"type": "string"
},
"encoding": {
"enum": [
"utf8",
"base64"
],
"type": "string",
"default": "utf8"
},
"filename": {
"type": "string",
"minLength": 1
}
}
},
"maxItems": 200
},
"driveFiles": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 200
},
"targetSlug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"minLength": 1
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Read one file the training archive kept a copy of
| Parameter | Type | Description |
|---|---|---|
| path * | string | |
| recordSlug * | string | |
| workspaceSlug * | string |
{
"name": "train_record_source_get",
"description": "Read one file the training archive kept a copy of",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"recordSlug",
"path"
],
"properties": {
"path": {
"type": "string",
"minLength": 1
},
"recordSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Reload a memory's archived sources into the staging inbox, re-scraping its URLs
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| recordSlug * | string | |
| workspaceSlug * | string |
{
"name": "train_record_restage",
"description": "Reload a memory's archived sources into the staging inbox, re-scraping its URLs",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"recordSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {}
},
"recordSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Add one durable memory without starting a training job.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "memory_create",
"description": "Add one durable memory without starting a training job.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"content",
"source"
],
"properties": {
"source": {
"enum": [
"user",
"agent",
"system",
"api",
"import"
],
"type": "string"
},
"content": {
"type": "string"
},
"sessionId": {
"type": "string"
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Search durable memory records by relevance.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "memory_search",
"description": "Search durable memory records by relevance.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"minLength": 1
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Add one durable memory to an agent's own memory without starting a training job.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_memory_create",
"description": "Add one durable memory to an agent's own memory without starting a training job.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"content",
"source"
],
"properties": {
"source": {
"enum": [
"user",
"agent",
"system",
"api",
"import"
],
"type": "string"
},
"content": {
"type": "string"
},
"sessionId": {
"type": "string"
}
}
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Search an agent's own durable memory records by relevance.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_memory_search",
"description": "Search an agent's own durable memory records by relevance.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug"
],
"properties": {
"query": {
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"minLength": 1
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1
}
}
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List recent training jobs newest first
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "train_job_list",
"description": "List recent training jobs newest first",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Get the progress and result state of one training job
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| workspaceSlug * | string |
{
"name": "train_job_get",
"description": "Get the progress and result state of one training job",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"jobId"
],
"properties": {
"jobId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List trained memory records newest first
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "train_record_list",
"description": "List trained memory records newest first",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List root and agent memory counts with trainable workspace agents.
| Parameter | Type | Description |
|---|---|---|
| workspaceSlug * | string |
{
"name": "train_memory_count_list",
"description": "List root and agent memory counts with trainable workspace agents.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read one trained memory record and its synthesized content
| Parameter | Type | Description |
|---|---|---|
| recordSlug * | string | |
| workspaceSlug * | string |
{
"name": "train_record_get",
"description": "Read one trained memory record and its synthesized content",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"recordSlug"
],
"properties": {
"recordSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Replace the synthesized content of one trained memory record
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| recordSlug * | string | |
| workspaceSlug * | string |
{
"name": "train_record_update",
"description": "Replace the synthesized content of one trained memory record",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"recordSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"content"
],
"properties": {
"content": {
"type": "string"
}
}
},
"recordSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Delete a trained memory record and its archived corpus
| Parameter | Type | Description |
|---|---|---|
| recordSlug * | string | |
| workspaceSlug * | string |
{
"name": "train_record_delete",
"description": "Delete a trained memory record and its archived corpus",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"recordSlug"
],
"properties": {
"recordSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Mint short-lived credentials for direct uploads to an agent training inbox
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_train_upload_session_create",
"description": "Mint short-lived credentials for direct uploads to an agent training inbox",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {}
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}List files waiting in an agent training inbox
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_train_upload_list",
"description": "List files waiting in an agent training inbox",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Scrape a public URL into an agent training inbox
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_train_upload_url_create",
"description": "Scrape a public URL into an agent training inbox",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string"
}
}
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}Remove one file from an agent training inbox
| Parameter | Type | Description |
|---|---|---|
| path * | string | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_train_upload_delete",
"description": "Remove one file from an agent training inbox",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"path"
],
"properties": {
"path": {
"type": "string",
"minLength": 1
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Snapshot staged sources and start an asynchronous agent training job
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_train_job_create",
"description": "Snapshot staged sources and start an asynchronous agent training job",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {
"urls": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 25
},
"files": {
"type": "array",
"items": {
"type": "object",
"required": [
"filename",
"content"
],
"properties": {
"content": {
"type": "string"
},
"encoding": {
"enum": [
"utf8",
"base64"
],
"type": "string",
"default": "utf8"
},
"filename": {
"type": "string",
"minLength": 1
}
}
},
"maxItems": 200
},
"driveFiles": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 200
},
"targetSlug": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
"minLength": 1
}
}
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}List recent agent training jobs newest first
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_train_job_list",
"description": "List recent agent training jobs newest first",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Get the progress and result state of one agent training job
| Parameter | Type | Description |
|---|---|---|
| jobId * | string | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_train_job_get",
"description": "Get the progress and result state of one agent training job",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"jobId"
],
"properties": {
"jobId": {
"type": "string",
"minLength": 1
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List trained agent memory records newest first
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| agentSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_train_record_list",
"description": "List trained agent memory records newest first",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read one trained agent memory record and its synthesized content
| Parameter | Type | Description |
|---|---|---|
| agentSlug * | string | |
| recordSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_train_record_get",
"description": "Read one trained agent memory record and its synthesized content",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"recordSlug"
],
"properties": {
"agentSlug": {
"type": "string",
"minLength": 1
},
"recordSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Replace the synthesized content of one trained agent memory record
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| agentSlug * | string | |
| recordSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_train_record_update",
"description": "Replace the synthesized content of one trained agent memory record",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"recordSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"content"
],
"properties": {
"content": {
"type": "string"
}
}
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"recordSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Delete a trained agent memory record and its archived corpus
| Parameter | Type | Description |
|---|---|---|
| agentSlug * | string | |
| recordSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_train_record_delete",
"description": "Delete a trained agent memory record and its archived corpus",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"recordSlug"
],
"properties": {
"agentSlug": {
"type": "string",
"minLength": 1
},
"recordSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Read one file an agent memory's training archive kept a copy of
| Parameter | Type | Description |
|---|---|---|
| path * | string | |
| agentSlug * | string | |
| recordSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_train_record_source_get",
"description": "Read one file an agent memory's training archive kept a copy of",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"recordSlug",
"path"
],
"properties": {
"path": {
"type": "string",
"minLength": 1
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"recordSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Reload an agent memory's archived sources into its staging inbox, re-scraping its URLs
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| agentSlug * | string | |
| recordSlug * | string | |
| workspaceSlug * | string |
{
"name": "agent_train_record_restage",
"description": "Reload an agent memory's archived sources into its staging inbox, re-scraping its URLs",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"agentSlug",
"recordSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {}
},
"agentSlug": {
"type": "string",
"minLength": 1
},
"recordSlug": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}Create a workspace and begin asynchronous provisioning.
| Parameter | Type | Description |
|---|---|---|
| body * | object |
{
"name": "workspace_create",
"description": "Create a workspace and begin asynchronous provisioning.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"slug",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"slug": {
"type": "string"
}
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Read the workspace payer, monthly spending cap, and storage allowance.
| Parameter | Type | Description |
|---|---|---|
| workspaceSlug * | string |
{
"name": "billing_get",
"description": "Read the workspace payer, monthly spending cap, and storage allowance.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Update the workspace payer, monthly spending cap, and storage allowance.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "billing_update",
"description": "Update the workspace payer, monthly spending cap, and storage allowance.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {
"payerUserId": {
"type": "string",
"minLength": 1
},
"extraStorageGb": {
"anyOf": [
{
"type": "number",
"const": 100
},
{
"type": "number",
"const": 200
},
{
"type": "number",
"const": 300
}
]
},
"monthlyCapMicroUsd": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Update workspace configuration, suspension, or its acknowledged public address.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "workspace_update",
"description": "Update workspace configuration, suspension, or its acknowledged public address.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"slug": {
"type": "string"
},
"suspended": {
"type": "boolean"
},
"defaultModel": {
"enum": [
"frontier",
"balanced",
"economy",
"openai-frontier",
"openai-max",
"anthropic-frontier",
"anthropic-max",
"anthropic-balanced",
"google-frontier",
"google-recommended",
"google-balanced"
],
"type": "string"
},
"suspensionReason": {
"type": "string"
},
"publicUrlBreakAcknowledged": {
"type": "boolean",
"const": true
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Permanently delete a workspace after confirming its current slug.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "workspace_delete",
"description": "Permanently delete a workspace after confirming its current slug.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"confirmation"
],
"properties": {
"confirmation": {
"type": "string"
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Page through newest-first workspace audit events.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "audit_list",
"description": "Page through newest-first workspace audit events.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}List current workspace members and the designated payer. search keeps a member only when every word starts a word of their name or email, so adding a word only narrows the results.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "member_list",
"description": "List current workspace members and the designated payer. search keeps a member only when every word starts a word of their name or email, so adding a word only narrows the results.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
},
"search": {
"type": "string",
"maxLength": 32,
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Change a member role while preserving payer and final-owner invariants.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| memberId * | string | |
| workspaceSlug * | string |
{
"name": "member_update",
"description": "Change a member role while preserving payer and final-owner invariants.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"memberId",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"role"
],
"properties": {
"role": {
"enum": [
"owner",
"editor",
"viewer"
],
"type": "string"
}
}
},
"memberId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Remove a member after payer and final-owner checks pass.
| Parameter | Type | Description |
|---|---|---|
| memberId * | string | |
| workspaceSlug * | string |
{
"name": "member_delete",
"description": "Remove a member after payer and final-owner checks pass.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"memberId"
],
"properties": {
"memberId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Leave the workspace after payer and final-owner checks pass.
| Parameter | Type | Description |
|---|---|---|
| workspaceSlug * | string |
{
"name": "workspace_leave",
"description": "Leave the workspace after payer and final-owner checks pass.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Invite an editor or viewer by canonical email address.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| workspaceSlug * | string |
{
"name": "invitation_create",
"description": "Invite an editor or viewer by canonical email address.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"body"
],
"properties": {
"body": {
"type": "object",
"required": [
"email"
],
"properties": {
"role": {
"enum": [
"editor",
"viewer"
],
"type": "string",
"description": "Defaults to editor."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}List recent invitations for a workspace.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "invitation_list",
"description": "List recent invitations for a workspace.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Revoke an invitation before it is consumed.
| Parameter | Type | Description |
|---|---|---|
| invitationId * | string | |
| workspaceSlug * | string |
{
"name": "invitation_revoke",
"description": "Revoke an invitation before it is consumed.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"invitationId"
],
"properties": {
"invitationId": {
"type": "string",
"minLength": 1
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Read workspace usage grouped over a reporting period.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "billing_usage_get",
"description": "Read workspace usage grouped over a reporting period.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"end": {
"type": "string"
},
"group": {
"enum": [
"workspace",
"user",
"app"
],
"type": "string",
"default": "workspace"
},
"start": {
"type": "string"
},
"period": {
"enum": [
"daily",
"weekly",
"monthly"
],
"type": "string",
"default": "monthly"
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read the workspace VM CPU, memory, and disk telemetry history.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| workspaceSlug * | string |
{
"name": "telemetry_get",
"description": "Read the workspace VM CPU, memory, and disk telemetry history.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"query": {
"type": "object",
"properties": {
"sinceAt": {
"type": "number",
"minimum": 0
}
}
},
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Read the workspace identity, configuration and suspension state.
| Parameter | Type | Description |
|---|---|---|
| workspaceSlug * | string |
{
"name": "workspace_get",
"description": "Read the workspace identity, configuration and suspension state.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Replace an owner-managed workspace runtime after an explicit recovery request.
| Parameter | Type | Description |
|---|---|---|
| workspaceSlug * | string |
{
"name": "workspace_reprovision",
"description": "Replace an owner-managed workspace runtime after an explicit recovery request.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Restart the current workspace VM from its persistent disk. The response acknowledges the provider request before the VM is ready.
| Parameter | Type | Description |
|---|---|---|
| workspaceSlug * | string |
{
"name": "workspace_restart",
"description": "Restart the current workspace VM from its persistent disk. The response acknowledges the provider request before the VM is ready.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug"
],
"properties": {
"workspaceSlug": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": true
}
}Discover upstream gateway model metadata. Filter by kind before paging. Reuse a cursor with the same filter; restart if the upstream list changes.
| Parameter | Type | Description |
|---|---|---|
| kind | string | one of ["language","image","video","embedding","realtime","reranking","speech","transcription"] |
| limit | integer | |
| query | object | |
| cursor | string | |
| method | string | one of ["GET","HEAD"] |
| headers | object | |
| workspace * | string |
{
"name": "model_list",
"description": "Discover upstream gateway model metadata. Filter by kind before paging. Reuse a cursor with the same filter; restart if the upstream list changes.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspace"
],
"properties": {
"kind": {
"enum": [
"language",
"image",
"video",
"embedding",
"realtime",
"reranking",
"speech",
"transcription"
],
"type": "string"
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
"cursor": {
"type": "string",
"pattern": "^\\d+$"
},
"method": {
"enum": [
"GET",
"HEAD"
],
"type": "string"
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"workspace": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}GET /v1/models/{id} passthrough. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.
| Parameter | Type | Description |
|---|---|---|
| query | object | |
| method | string | one of ["GET","HEAD"] |
| headers | object | |
| modelId * | string | |
| workspace * | string |
{
"name": "model_get",
"description": "GET /v1/models/{id} passthrough. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspace",
"modelId"
],
"properties": {
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
"method": {
"enum": [
"GET",
"HEAD"
],
"type": "string"
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"modelId": {
"type": "string",
"minLength": 1
},
"workspace": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}POST /v1/chat/completions and SDK language-model paths; full native body/options. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| query | object | |
| headers | object | |
| protocol | string | one of ["/v1/chat/completions","/v4/ai/language-model","/language-model"] |
| workspace * | string |
{
"name": "model_chat",
"description": "POST /v1/chat/completions and SDK language-model paths; full native body/options. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspace",
"body"
],
"properties": {
"body": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"protocol": {
"enum": [
"/v1/chat/completions",
"/v4/ai/language-model",
"/language-model"
],
"type": "string"
},
"workspace": {
"type": "string"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}POST /v1/responses; full native body/options. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| query | object | |
| headers | object | |
| workspace * | string |
{
"name": "model_responses",
"description": "POST /v1/responses; full native body/options. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspace",
"body"
],
"properties": {
"body": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"workspace": {
"type": "string"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}POST /v1/messages; full native body/options. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| query | object | |
| headers | object | |
| protocol | string | one of ["/v1/messages","/messages"] |
| workspace * | string |
{
"name": "model_messages",
"description": "POST /v1/messages; full native body/options. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspace",
"body"
],
"properties": {
"body": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"protocol": {
"enum": [
"/v1/messages",
"/messages"
],
"type": "string"
},
"workspace": {
"type": "string"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Native image-model / v4 AI / images generations paths and options. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| query | object | |
| headers | object | |
| protocol | string | one of ["/v4/ai/image-model","/image-model","/v4/ai/image","/v1/images/generations"] |
| workspace * | string |
{
"name": "model_image",
"description": "Native image-model / v4 AI / images generations paths and options. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspace",
"body"
],
"properties": {
"body": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"protocol": {
"enum": [
"/v4/ai/image-model",
"/image-model",
"/v4/ai/image",
"/v1/images/generations"
],
"type": "string"
},
"workspace": {
"type": "string"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Native video-model / v4 AI paths and options. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| query | object | |
| headers | object | |
| protocol | string | one of ["/v4/ai/video-model","/video-model","/v4/ai/video"] |
| workspace * | string |
{
"name": "model_video",
"description": "Native video-model / v4 AI paths and options. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspace",
"body"
],
"properties": {
"body": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"protocol": {
"enum": [
"/v4/ai/video-model",
"/video-model",
"/v4/ai/video"
],
"type": "string"
},
"workspace": {
"type": "string"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}POST native video-model/start; preserve opaque operation and callback/options. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| query | object | |
| headers | object | |
| protocol | string | one of ["/v4/ai/video-model/start","/video-model/start"] |
| workspace * | string |
{
"name": "model_video_start",
"description": "POST native video-model/start; preserve opaque operation and callback/options. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspace",
"body"
],
"properties": {
"body": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"protocol": {
"enum": [
"/v4/ai/video-model/start",
"/video-model/start"
],
"type": "string"
},
"workspace": {
"type": "string"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}POST native video-model/status; preserve pending/completed/error/cancelled and native results. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| query | object | |
| headers | object | |
| protocol | string | one of ["/v4/ai/video-model/status","/video-model/status"] |
| workspace * | string |
{
"name": "model_video_status",
"description": "POST native video-model/status; preserve pending/completed/error/cancelled and native results. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspace",
"body"
],
"properties": {
"body": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"protocol": {
"enum": [
"/v4/ai/video-model/status",
"/video-model/status"
],
"type": "string"
},
"workspace": {
"type": "string"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Native embedding-model / v4 AI / embeddings paths and options. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.
| Parameter | Type | Description |
|---|---|---|
| body * | object | |
| query | object | |
| headers | object | |
| protocol | string | one of ["/v1/embeddings","/embedding-model","/v4/ai/embedding-model"] |
| workspace * | string |
{
"name": "model_embedding",
"description": "Native embedding-model / v4 AI / embeddings paths and options. Complete native body and headers; select protocol from the fixed supported paths. Exact model IDs are forwarded unchanged.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspace",
"body"
],
"properties": {
"body": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
},
"query": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"protocol": {
"enum": [
"/v1/embeddings",
"/embedding-model",
"/v4/ai/embedding-model"
],
"type": "string"
},
"workspace": {
"type": "string"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Generate image or video media through the Bento model gateway using an exact upstream model ID or role. Roles: image, image:google, video, video:grok, video:pro, video:seedance, video:google, video:kling, video:kling:image. Omit model to use the role matching kind. Optional video controls: duration in seconds and resolution as WIDTHxHEIGHT.
| Parameter | Type | Description |
|---|---|---|
| kind | string | one of ["image","video"] |
| model | string | |
| prompt * | string | |
| duration | number | |
| workspace * | string | |
| resolution | string |
{
"name": "media_generate",
"description": "Generate image or video media through the Bento model gateway using an exact upstream model ID or role. Roles: image, image:google, video, video:grok, video:pro, video:seedance, video:google, video:kling, video:kling:image. Omit model to use the role matching kind. Optional video controls: duration in seconds and resolution as WIDTHxHEIGHT.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspace",
"prompt"
],
"properties": {
"kind": {
"enum": [
"image",
"video"
],
"type": "string",
"default": "image"
},
"model": {
"type": "string",
"minLength": 1
},
"prompt": {
"type": "string",
"minLength": 1
},
"duration": {
"type": "number",
"exclusiveMinimum": 0
},
"workspace": {
"type": "string"
},
"resolution": {
"type": "string",
"pattern": "^-?\\d+(?:\\.\\d+)?x-?\\d+(?:\\.\\d+)?$"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"destructiveHint": false
}
}Call an allowlisted third-party service route through Bento. JSON results are returned intact. Other bytes are persisted to outputPath or a new Drive file using current file authority; no service call is repeated.
| Parameter | Type | Description |
|---|---|---|
| raw | string | |
| body | any | |
| form | array | |
| path * | string | |
| bytes | string | |
| query | any | |
| headers | object | |
| serviceId * | string | |
| outputPath | string | |
| workspaceSlug * | string |
Call an allowlisted third-party service route through Bento. JSON results are returned intact. Other bytes are persisted to outputPath or a new Drive file using current file authority; no service call is repeated.
| Parameter | Type | Description |
|---|---|---|
| raw | string | |
| body | any | |
| form | array | |
| path * | string | |
| bytes | string | |
| query | any | |
| headers | object | |
| serviceId * | string | |
| outputPath | string | |
| workspaceSlug * | string |
Call an allowlisted third-party service route through Bento. JSON results are returned intact. Other bytes are persisted to outputPath or a new Drive file using current file authority; no service call is repeated.
| Parameter | Type | Description |
|---|---|---|
| raw | string | |
| body | any | |
| form | array | |
| path * | string | |
| bytes | string | |
| query | any | |
| headers | object | |
| serviceId * | string | |
| outputPath | string | |
| workspaceSlug * | string |
Call an allowlisted third-party service route through Bento. JSON results are returned intact. Other bytes are persisted to outputPath or a new Drive file using current file authority; no service call is repeated.
| Parameter | Type | Description |
|---|---|---|
| raw | string | |
| body | any | |
| form | array | |
| path * | string | |
| bytes | string | |
| query | any | |
| headers | object | |
| serviceId * | string | |
| outputPath | string | |
| workspaceSlug * | string |
Call an allowlisted third-party service route through Bento. JSON results are returned intact. Other bytes are persisted to outputPath or a new Drive file using current file authority; no service call is repeated.
| Parameter | Type | Description |
|---|---|---|
| raw | string | |
| body | any | |
| form | array | |
| path * | string | |
| bytes | string | |
| query | any | |
| headers | object | |
| serviceId * | string | |
| outputPath | string | |
| workspaceSlug * | string |
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
Too large to show here.
{
"name": "service_proxy_get",
"description": "Call an allowlisted third-party service route through Bento. JSON results are returned intact. Other bytes are persisted to outputPath or a new Drive file using current file authority; no service call is repeated.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"serviceId",
"path"
],
"properties": {
"raw": {
"type": "string"
},
"body": {
"allOf": [
{
"$ref": "#/definitions/__schema0"
}
]
},
"form": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"value"
],
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
},
"encoding": {
"type": "string",
"const": "text"
},
"filename": {
"type": "string"
},
"contentType": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"name",
"value",
"encoding"
],
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string",
"format": "base64",
"pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
"contentEncoding": "base64"
},
"encoding": {
"type": "string",
"const": "base64"
},
"filename": {
"type": "string"
},
"contentType": {
"type": "string"
}
},
"additionalProperties": false
}
]
}
},
"path": {
"type": "string",
"minLength": 1
},
"bytes": {
"type": "string",
"format": "base64",
"pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
"contentEncoding": "base64"
},
"query": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
{
"type": "array",
"items": {
"type": "array",
"items": [
{
"type": "string"
},
{
"type": "string"
}
]
}
}
]
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"serviceId": {
"type": "string",
"minLength": 1
},
"outputPath": {
"type": "string"
},
"workspaceSlug": {
"type": "string"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}{
"name": "service_proxy_post",
"description": "Call an allowlisted third-party service route through Bento. JSON results are returned intact. Other bytes are persisted to outputPath or a new Drive file using current file authority; no service call is repeated.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"serviceId",
"path"
],
"properties": {
"raw": {
"type": "string"
},
"body": {
"allOf": [
{
"$ref": "#/definitions/__schema0"
}
]
},
"form": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"value"
],
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
},
"encoding": {
"type": "string",
"const": "text"
},
"filename": {
"type": "string"
},
"contentType": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"name",
"value",
"encoding"
],
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string",
"format": "base64",
"pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
"contentEncoding": "base64"
},
"encoding": {
"type": "string",
"const": "base64"
},
"filename": {
"type": "string"
},
"contentType": {
"type": "string"
}
},
"additionalProperties": false
}
]
}
},
"path": {
"type": "string",
"minLength": 1
},
"bytes": {
"type": "string",
"format": "base64",
"pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
"contentEncoding": "base64"
},
"query": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
{
"type": "array",
"items": {
"type": "array",
"items": [
{
"type": "string"
},
{
"type": "string"
}
]
}
}
]
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"serviceId": {
"type": "string",
"minLength": 1
},
"outputPath": {
"type": "string"
},
"workspaceSlug": {
"type": "string"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}{
"name": "service_proxy_put",
"description": "Call an allowlisted third-party service route through Bento. JSON results are returned intact. Other bytes are persisted to outputPath or a new Drive file using current file authority; no service call is repeated.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"serviceId",
"path"
],
"properties": {
"raw": {
"type": "string"
},
"body": {
"allOf": [
{
"$ref": "#/definitions/__schema0"
}
]
},
"form": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"value"
],
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
},
"encoding": {
"type": "string",
"const": "text"
},
"filename": {
"type": "string"
},
"contentType": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"name",
"value",
"encoding"
],
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string",
"format": "base64",
"pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
"contentEncoding": "base64"
},
"encoding": {
"type": "string",
"const": "base64"
},
"filename": {
"type": "string"
},
"contentType": {
"type": "string"
}
},
"additionalProperties": false
}
]
}
},
"path": {
"type": "string",
"minLength": 1
},
"bytes": {
"type": "string",
"format": "base64",
"pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
"contentEncoding": "base64"
},
"query": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
{
"type": "array",
"items": {
"type": "array",
"items": [
{
"type": "string"
},
{
"type": "string"
}
]
}
}
]
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"serviceId": {
"type": "string",
"minLength": 1
},
"outputPath": {
"type": "string"
},
"workspaceSlug": {
"type": "string"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}{
"name": "service_proxy_patch",
"description": "Call an allowlisted third-party service route through Bento. JSON results are returned intact. Other bytes are persisted to outputPath or a new Drive file using current file authority; no service call is repeated.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"serviceId",
"path"
],
"properties": {
"raw": {
"type": "string"
},
"body": {
"allOf": [
{
"$ref": "#/definitions/__schema0"
}
]
},
"form": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"value"
],
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
},
"encoding": {
"type": "string",
"const": "text"
},
"filename": {
"type": "string"
},
"contentType": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"name",
"value",
"encoding"
],
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string",
"format": "base64",
"pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
"contentEncoding": "base64"
},
"encoding": {
"type": "string",
"const": "base64"
},
"filename": {
"type": "string"
},
"contentType": {
"type": "string"
}
},
"additionalProperties": false
}
]
}
},
"path": {
"type": "string",
"minLength": 1
},
"bytes": {
"type": "string",
"format": "base64",
"pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
"contentEncoding": "base64"
},
"query": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
{
"type": "array",
"items": {
"type": "array",
"items": [
{
"type": "string"
},
{
"type": "string"
}
]
}
}
]
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"serviceId": {
"type": "string",
"minLength": 1
},
"outputPath": {
"type": "string"
},
"workspaceSlug": {
"type": "string"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}{
"name": "service_proxy_delete",
"description": "Call an allowlisted third-party service route through Bento. JSON results are returned intact. Other bytes are persisted to outputPath or a new Drive file using current file authority; no service call is repeated.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"workspaceSlug",
"serviceId",
"path"
],
"properties": {
"raw": {
"type": "string"
},
"body": {
"allOf": [
{
"$ref": "#/definitions/__schema0"
}
]
},
"form": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"required": [
"name",
"value"
],
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
},
"encoding": {
"type": "string",
"const": "text"
},
"filename": {
"type": "string"
},
"contentType": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"name",
"value",
"encoding"
],
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string",
"format": "base64",
"pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
"contentEncoding": "base64"
},
"encoding": {
"type": "string",
"const": "base64"
},
"filename": {
"type": "string"
},
"contentType": {
"type": "string"
}
},
"additionalProperties": false
}
]
}
},
"path": {
"type": "string",
"minLength": 1
},
"bytes": {
"type": "string",
"format": "base64",
"pattern": "^$|^(?:[0-9a-zA-Z+/]{4})*(?:(?:[0-9a-zA-Z+/]{2}==)|(?:[0-9a-zA-Z+/]{3}=))?$",
"contentEncoding": "base64"
},
"query": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
{
"type": "array",
"items": {
"type": "array",
"items": [
{
"type": "string"
},
{
"type": "string"
}
]
}
}
]
},
"headers": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"serviceId": {
"type": "string",
"minLength": 1
},
"outputPath": {
"type": "string"
},
"workspaceSlug": {
"type": "string"
}
},
"definitions": {
"__schema0": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
},
{
"type": "array",
"items": {
"$ref": "#/definitions/__schema0"
}
},
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"$ref": "#/definitions/__schema0"
}
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": true
}
}