> ## 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.

# source

> Command reference: ish source.

## `ish source upload`

Upload a file as a participant attachment and wait for processing

Usage: `ish source upload <file> [options]`

### Arguments

<ParamField path="file">Local file path (transcript, audio, image, PDF, etc.) (required)</ParamField>

### Options

<ParamField path="--workspace <id>" type="string">Workspace (product) ID; falls back to active workspace</ParamField>
<ParamField path="--kind <kind>" type="string">Attachment kind: text\_file | audio | image (auto-detected if omitted; hyphen/underscore variants accepted)</ParamField>
<ParamField path="--description <text>" type="string">Context note attached to the file (max 500 chars)</ParamField>
<ParamField path="--diarize" type="boolean">Accepted for backward compat; audio diarization is the worker default and the flag is ignored.</ParamField>
<ParamField path="--no-wait" type="boolean">Don't poll until terminal status - return after confirm</ParamField>
<ParamField path="--timeout <seconds>" type="string">Poll timeout in seconds (default 300) Default: "300".</ParamField>

## `ish source get`

Get a participant attachment's current status

Usage: `ish source get <id> [options]`

### Arguments

<ParamField path="id">Attachment ID or alias (required)</ParamField>

### Options

<ParamField path="--workspace <id>" type="string">Workspace ID; accepted for consistency (inferred from alias / active context)</ParamField>

## `ish source delete`

Delete a participant attachment plus its uploaded file

Usage: `ish source delete <id> [options]`

### Arguments

<ParamField path="id">Attachment ID or alias (required)</ParamField>

### Options

<ParamField path="-y, --yes" type="boolean">Skip confirmation prompt (required in --json or non-TTY contexts)</ParamField>
<ParamField path="--workspace <id>" type="string">Workspace ID; accepted for consistency (inferred from alias / active context)</ParamField>

## Global flags

Every command accepts the global flags.

<ParamField path="-V, --version" type="boolean">output the version number</ParamField>
<ParamField path="-t, --token <token>" type="string">Auth token (or set ISH\_TOKEN env var)</ParamField>
<ParamField path="--token-file <path>" type="string">Read auth token from a file (preferred over --token / ISH\_TOKEN)</ParamField>
<ParamField path="--workspace <id>" type="string">Default workspace ID; per-subcommand --workspace overrides</ParamField>
<ParamField path="--json" type="boolean">Output as JSON (auto-enabled when piped)</ParamField>
<ParamField path="--get <field>" type="string">Extract a single field from the JSON response and print only its value (implies --json internally; supports dotted paths e.g. person.name)</ParamField>
<ParamField path="--human" type="boolean">Force human-readable output even when stdout is piped (overrides JSON-when-piped auto-detection)</ParamField>
<ParamField path="--fields <fields>" type="string">Comma-separated fields to include in JSON output (e.g. alias,name,status)</ParamField>
<ParamField path="--verbose" type="boolean">Include full UUIDs and timestamps in JSON output</ParamField>
<ParamField path="--no-color" type="boolean">Disable colored output (also honored: NO\_COLOR env var)</ParamField>
<ParamField path="-q, --quiet" type="boolean">Suppress progress messages on stderr (no-op for read commands that emit none)</ParamField>