> ## Documentation Index > Fetch the complete documentation index at: https://docs.ishlabs.io/llms.txt > Use this file to discover all available pages before exploring further. # chat > Command reference: ish chat. ## `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 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 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 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 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 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 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 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)