Sign in

v1

latestOpenAPI 3.1.02026-08-047777149.4 KB
Commands

Create a chat command

Create a slash-command. Set cron_schedule to run the command on a schedule and deliver artifacts to sink_configs.

post/api/v3/workspaces/{workspace}/chat-config/commands

Path parameters

workspacestring required

Workspace short name

Request body

namestring required
command_contentstring required

The prompt the assistant runs

scope_type'workspace' | 'persona' | 'user' required
scope_idstring nullable

Required for persona scope (persona short name)

descriptionstring
is_activeboolean
cron_schedulestring

Cron expression to schedule the command (optional)

sink_configsobject[]

Delivery sinks for scheduled artifacts (optional)

assistant_namestring

Assistant persona for scheduled fires (optional)

run_as_userstring

User identity scheduled fires run as (optional)

max_runsinteger

Cap on total scheduled runs (optional)

auto_approve_readonlyboolean

Auto-approve read-only tasks on scheduled fires (optional)

Response

Command created

idinteger
namestring
command_contentstring

The prompt the assistant runs

descriptionstring nullable
scope_type'workspace' | 'persona' | 'user'
scope_idstring nullable
workspace_namestring
is_activeboolean
cron_schedulestring nullable

Cron expression for scheduled runs (optional)

sink_configsobject[]

Delivery sinks for scheduled command artifacts (e.g. Slack)

assistant_namestring nullable

Assistant persona that runs scheduled fires

created_atstring date-time
updated_atstring date-time