ish chat endpoint
Manage saved chatbot endpoints
Usage: ish chat endpoint
ish chat endpoint list
List chatbot endpoints in the current workspace
Usage: ish chat endpoint list [options]
Options
Workspace ID
ish chat endpoint get
Get a chatbot endpoint by id (or the active endpoint)
Usage: ish chat endpoint get [id] [options]
Arguments
id
Endpoint alias or UUID; defaults to the active endpoint (optional)
Options
Endpoint alias or UUID (alternative to positional)
ish chat endpoint create
Create a chatbot endpoint from a hand-written ChatbotEndpointConfig JSON (advanced - use chat endpoint init to infer the config from a curl sample, JSON, or template).
Usage: ish chat endpoint create [options]
Options
Path to JSON file (or ”-” for stdin) Required.
Override the name from the config file
Workspace ID
Mark this endpoint as tunnel-backed (overrides envelope/config)
Force tunnel-backed off (overrides envelope/config)
ish chat endpoint update
Update a chatbot endpoint (full replace via —endpoint-config, or per-field shorthand)
Usage: ish chat endpoint update [id] [options]
Arguments
id
Endpoint alias or UUID; defaults to the active endpoint (optional)
Options
Endpoint alias or UUID (alternative to positional)
Replace config from JSON file (or ”-” for stdin)
Rename the endpoint
Replace outgoing.url
Replace outgoing.method (POST | PUT)
Replace outgoing.mode (stateful | stateless)
Set isTunnelBacked=true
Set isTunnelBacked=false
ish chat endpoint delete
Delete a chatbot endpoint
Usage: ish chat endpoint delete [id] [options]
Arguments
id
Endpoint alias or UUID; defaults to the active endpoint (optional)
Options
Endpoint alias or UUID (alternative to positional)
Skip confirmation prompt (required in —json or non-TTY contexts)
ish chat endpoint use
Set the active chat endpoint (saved to ~/.ish/config.json)
Usage: ish chat endpoint use [id] [options]
Arguments
id
Endpoint alias or UUID (optional)
Options
Remove the active chat endpoint from config
ish chat endpoint init
Author an endpoint from a curl/JSON sample via test-and-map, or from a known-good template (recommended for most users - use chat endpoint create only when you already have a hand-written ChatbotEndpointConfig).
Usage: ish chat endpoint init [options]
Options
Path to a curl example file (or ”-” for stdin)
Path to a JSON request/response sample (or ”-” for stdin)
Start from a known-good template (one of: openai, anthropic, voiceflow, dialogflow-cx, botframework)
Save the inferred config under this display name
Infer the shape without persisting it
Workspace ID
Force isTunnelBacked=true (overrides localhost auto-detect)
Force isTunnelBacked=false (overrides localhost auto-detect)
ish chat endpoint test
Send one message to a saved endpoint and return the bot’s reply
Usage: ish chat endpoint test [endpoint-id] [options]
Arguments
endpoint-id
Endpoint alias or UUID; defaults to the active endpoint (optional)
Options
Endpoint alias or UUID (alternative to positional)
Message to send Default: “Hello”.
Thread state across multiple invocations (stateful endpoints)
Participant persona JSON ({name, locale, …}) exposed via {{participant.*}}
Include the dispatched POST body in the output
Workspace ID
ish chat endpoint map
Map a chatbot contract from documentation (and optionally a saved endpoint draft) via /chat/test-and-map
Usage: ish chat endpoint map [options]
Options
Path to documentation file (curl, JSON, OpenAPI snippet, freeform). Use ”-” for stdin
Saved endpoint alias or UUID - its config seeds the draft endpoint. Optional.
Workspace ID
ish chat config
Manage chatbot configurations (agent shape: model, prompt, tools, sub-agents)
Usage: ish chat config
ish chat config list
List configurations under a chatbot endpoint
Usage: ish chat config list [options]
Options
Endpoint alias or UUID (defaults to active endpoint)
ish chat config set
Create or update a chatbot configuration (composite upsert)
Usage: ish chat config set [options]
Options
Configuration name (unique per endpoint) Required.
Endpoint alias or UUID (defaults to active endpoint; create only)
Configuration alias or UUID - switches to update mode
Optional version tag (e.g. v3, 1.2.0, git sha)
Optional description
Primary model identifier (e.g. claude-sonnet-4-6)
System prompt text
Read system prompt from file (or ”-” for stdin)
JSON array of tools (or ”-” for stdin)
JSON array of sub-agents (or ”-” for stdin)
Custom field; repeat. Replaces all custom fields on update.
Mark as the endpoint’s default configuration
ish chat config get
Get a chatbot configuration (or its referencing iterations)
Usage: ish chat config get [id] [options]
Arguments
id
Configuration alias or UUID (optional)
Options
Configuration alias or UUID (alternative to positional)
default | iterations.
iterations returns the cross-study aggregation list. Default: “default”.ish chat config delete
Delete a chatbot configuration (rejected when iterations reference it)
Usage: ish chat config delete [id] [options]
Arguments
id
Configuration alias or UUID (optional)
Options
Configuration alias or UUID (alternative to positional)
Skip confirmation prompt
Global flags
Every command accepts the global flags.output the version number
Auth token (or set ISH_TOKEN env var)
Read auth token from a file (preferred over —token / ISH_TOKEN)
Default workspace ID; per-subcommand —workspace overrides
Output as JSON (auto-enabled when piped)
Extract a single field from the JSON response and print only its value (implies —json internally; supports dotted paths e.g. person.name)
Force human-readable output even when stdout is piped (overrides JSON-when-piped auto-detection)
Comma-separated fields to include in JSON output (e.g. alias,name,status)
Include full UUIDs and timestamps in JSON output
Disable colored output (also honored: NO_COLOR env var)
Suppress progress messages on stderr (no-op for read commands that emit none)