ChatGPT ↗
Claude ↗This page relies on CLI-specific workflow helpers and local operator behavior.
Install and inspect your version
pipx install autotouch-cli
pipx upgrade autotouch-cli
autotouch --version
autotouch cli-reference --source bundled
autotouch cli-manifest --source bundled --output jsonThis reference follows repository source. Package publication and backend deployment are separate. Inspect the installed binary and the selected server's live capabilities before execution. Session-only commands require the signed-in user's credential and cannot use a developer API key.
Quickstart · Authentication · Operation discovery
Full Markdown reference · Machine-readable manifest · Agent playbook
Command groups
- auth
- blacklist
- calendar
- capabilities
- capacity
- cells
- cli-manifest
- cli-reference
- columns
- companies
- context
- crm
- deals
- event-streams
- integrations
- jobs
- leads
- list-build
- notes
- onboarding
- org-context
- organization
- outreach
- personal-context
- prompts
- rows
- run
- run-next
- scheduled
- schema
- search
- sender-accounts
- sequences
- setup
- signals
- sop
- status
- tables
- tasks
- watch
- webhooks
- workflows
- workspace-secrets
- workspace-views
- workspaces
auth
autotouch auth — Auth helpers
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: check, status, bootstrap, login, set-key, show, whoami, clear, schema.
autotouch auth [-h]
{check,status,bootstrap,login,set-key,show,config,whoami,clear,schema}
...autotouch auth bootstrap — Retired public account-and-key bootstrap
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
This command is retired. Register and sign in through the web app, then create a developer API key from the authenticated workspace.
| Argument | Contract | Description |
|---|---|---|
--first-name | string | First name |
--last-name | string | Last name |
--email | string | User email |
--password | string; sensitive | Password |
--organization-name | string | Organization name |
--key-name | string | Developer key label (default: Agent bootstrap key) |
--expires-at | string | Optional developer key expiry ISO timestamp |
--scopes-json | json; input: json | Optional JSON array of scopes |
--scopes-file | file; input: file | Optional JSON file with scopes array |
--data-json | json; input: json | Explicit agent bootstrap payload JSON |
--data-file | file; input: file | Path to agent bootstrap payload JSON file |
--save-key | boolean; when omitted=false; when present=true | Persist the returned apiKey and bootstrap a saved JWT session |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch auth bootstrap [-h] [--first-name FIRST_NAME]
[--last-name LAST_NAME] [--email EMAIL]
[--password PASSWORD]
[--organization-name ORGANIZATION_NAME]
[--key-name KEY_NAME]
[--expires-at EXPIRES_AT]
[--scopes-json SCOPES_JSON]
[--scopes-file SCOPES_FILE]
[--data-json DATA_JSON]
[--data-file DATA_FILE] [--save-key]
[--base-url BASE_URL] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch auth check — Validate the current token/session and show granted scopes
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Validate the current token/session against the API and show granted scopes for developer API keys.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch auth check [-h] [--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch auth clear — Clear stored auth config
Auth: none. Stability: stable. Destructive: yes.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--all | boolean; when omitted=false; when present=true | Clear all config keys |
--clear-base-url | boolean; when omitted=false; when present=true | Also clear stored base_url |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch auth clear [-h] [--all] [--clear-base-url]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch auth login — Authenticate with email/password and persist a JWT session
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--email | string | User email |
--password | string; sensitive | Password (prompted if omitted in a TTY) |
--data-json | json; input: json | Explicit auth login payload JSON |
--data-file | file; input: file | Path to auth login payload JSON file |
--no-save-session | boolean; when omitted=true; when present=false | Do not persist the returned access token |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch auth login [-h] [--email EMAIL] [--password PASSWORD]
[--data-json DATA_JSON] [--data-file DATA_FILE]
[--no-save-session] [--base-url BASE_URL]
[--timeout TIMEOUT] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch auth schema — Print auth payload schemas
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, login; default: "all" | |
--out-file | file; input: file | Write schema JSON to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch auth schema [-h] [--type {all,login}] [--out-file OUT_FILE]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch auth set-key — Persist API key/base URL to user config
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--api-key | string; sensitive | Developer API key to store (defaults from env if omitted) |
--base-url | string | Default API base URL (default: https://app.autotouch.ai) |
--overwrite | boolean; when omitted=false; when present=true | Replace existing stored API key |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch auth set-key [-h] [--api-key API_KEY] [--base-url BASE_URL]
[--overwrite] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch auth show — Show current local auth config
Auth: none. Stability: stable. Destructive: no.
Aliases: config.
Output modes: json, ndjson, human.
Show the locally saved auth config only. This command does not contact the API.
| Argument | Contract | Description |
|---|---|---|
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch auth show [-h] [--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch auth status — Resolve auth, identity, and credit/allowance context
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Fetch the effective auth context plus organization/user credit state. This is the best one-command status check when a key is valid but pointed at the wrong org or the real blocker is allowance/quota state rather than authentication.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch auth status [-h] [--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch auth whoami — Show the current saved user session identity
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--token | string; sensitive | Explicit JWT session token |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch auth whoami [-h] [--token TOKEN] [--base-url BASE_URL]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]blacklist
autotouch blacklist — Organization blacklist operations (admin)
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, add, remove, import, check, filter.
autotouch blacklist [-h] {list,add,remove,import,check,filter} ...autotouch blacklist add — Add a blacklist entry
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; required; choices: email, domain | Entry type |
--value | string; required; sensitive | Email or domain value |
--reason | string; default: "" | Optional reason |
--notes | string; default: "" | Optional notes |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch blacklist add [-h] --type {email,domain} --value VALUE
[--reason REASON] [--notes NOTES]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch blacklist check — Check whether emails are blacklisted
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--email | string; repeatable; comma-separated | Email value (repeatable; comma-separated also supported) |
--emails-json | json; input: json | JSON array or object with emails[] |
--emails-file | file; input: file | Path to .txt/.csv/.json email list |
--emails-column | string; default: "email" | CSV column for emails (default: email) |
--chunk-size | integer; default: 1000 | Request chunk size (max 1000, default: 1000) |
--summary-only | boolean; when omitted=false; when present=true | Omit per-email results |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch blacklist check [-h] [--email EMAIL]
[--emails-json EMAILS_JSON]
[--emails-file EMAILS_FILE]
[--emails-column EMAILS_COLUMN]
[--chunk-size CHUNK_SIZE] [--summary-only]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch blacklist filter — Filter blacklisted emails from a list
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--email | string; repeatable; comma-separated | Email value (repeatable; comma-separated also supported) |
--emails-json | json; input: json | JSON array or object with emails[] |
--emails-file | file; input: file | Path to .txt/.csv/.json email list |
--emails-column | string; default: "email" | CSV column for emails (default: email) |
--chunk-size | integer; default: 10000 | Request chunk size (max 10000, default: 10000) |
--summary-only | boolean; when omitted=false; when present=true | Omit full clean/blocked lists |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch blacklist filter [-h] [--email EMAIL]
[--emails-json EMAILS_JSON]
[--emails-file EMAILS_FILE]
[--emails-column EMAILS_COLUMN]
[--chunk-size CHUNK_SIZE] [--summary-only]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch blacklist import — Import blacklist entries from CSV/TXT
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--file | file; required; input: file | Path to CSV/TXT file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch blacklist import [-h] --file FILE [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch blacklist list — List blacklist entries
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type-filter | string; choices: all, email, domain; default: "all" | |
--search | string | Filter by value/reason/notes |
--page | integer; default: 1 | Page number (default: 1) |
--limit | integer; default: 100 | Entries per page (default: 100) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch blacklist list [-h] [--type-filter {all,email,domain}]
[--search SEARCH] [--page PAGE]
[--limit LIMIT] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch blacklist remove — Remove a blacklist entry by id
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--entry-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch blacklist remove [-h] --entry-id ENTRY_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]calendar
autotouch calendar — Personal Calendar operations (requires Calendar enabled and a connected provider)
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: connections, agenda, get-agenda-event, events, get-event, update-event, delete-event, send-lead-invite.
autotouch calendar [-h]
{connections,agenda,get-agenda-event,events,get-event,update-event,delete-event,send-lead-invite}
...autotouch calendar agenda — Read a bounded calendar agenda page
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Read a bounded calendar agenda page. Available only when Calendar is enabled, with the caller's connected calendar and event ownership checks; read/write developer-key scopes apply.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: google, microsoft | |
--start | string; required | ISO 8601 datetime with a UTC offset; range is bounded to 90 days |
--end | string; required | ISO 8601 datetime with a UTC offset; range is bounded to 90 days |
--query | string | |
--attendee | string | |
--attendee-domain | string | |
--page-size | integer | |
--cursor | string | |
--projection | string; choices: compact, full | |
--include-crm-context | boolean; when omitted=null; when present=true | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch calendar agenda [-h] --provider {google,microsoft} --start
START --end END [--query QUERY]
[--attendee ATTENDEE]
[--attendee-domain ATTENDEE_DOMAIN]
[--page-size PAGE_SIZE] [--cursor CURSOR]
[--projection {compact,full}]
[--include-crm-context] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch calendar connections — List the caller's connected calendars
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
List the caller's connected calendars. Available only when Calendar is enabled, with the caller's connected calendar and event ownership checks; read/write developer-key scopes apply.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch calendar connections [-h] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch calendar delete-event — Cancel a Lead-associated calendar event
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Cancel a Lead-associated calendar event. Available only when Calendar is enabled, with the caller's connected calendar and event ownership checks; read/write developer-key scopes apply.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: google, microsoft | |
--event-id | string; required | |
--expected-etag | string | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch calendar delete-event [-h] --provider {google,microsoft}
--event-id EVENT_ID
[--expected-etag EXPECTED_ETAG]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch calendar events — List Lead-associated calendar events in a bounded time range
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
List Lead-associated calendar events in a bounded time range. Available only when Calendar is enabled, with the caller's connected calendar and event ownership checks; read/write developer-key scopes apply.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: google, microsoft | |
--start | string; required | ISO 8601 datetime with a UTC offset; range is bounded to 90 days |
--end | string; required | ISO 8601 datetime with a UTC offset; range is bounded to 90 days |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch calendar events [-h] --provider {google,microsoft} --start
START --end END [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch calendar get-agenda-event — Read one event from the caller's agenda
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Read one event from the caller's agenda. Available only when Calendar is enabled, with the caller's connected calendar and event ownership checks; read/write developer-key scopes apply.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: google, microsoft | |
--event-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch calendar get-agenda-event [-h] --provider {google,microsoft}
--event-id EVENT_ID
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch calendar get-event — Read one Lead-associated calendar event
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Read one Lead-associated calendar event. Available only when Calendar is enabled, with the caller's connected calendar and event ownership checks; read/write developer-key scopes apply.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: google, microsoft | |
--event-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch calendar get-event [-h] --provider {google,microsoft}
--event-id EVENT_ID [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch calendar send-lead-invite — Send an invite from the caller's connected calendar to explicit CRM Leads
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Send an invite from the caller's connected calendar to explicit CRM Leads. Available only when Calendar is enabled, with the caller's connected calendar and event ownership checks; read/write developer-key scopes apply.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: google, microsoft | |
--data-json | json; input: json | CreateLeadInvite: request_id (UUID), lead_id or lead_ids, title, start, end; optional teammate_ids, guest_emails, description, add_video_conference as JSON |
--data-file | file; input: file | Path to CreateLeadInvite: request_id (UUID), lead_id or lead_ids, title, start, end; optional teammate_ids, guest_emails, description, add_video_conference JSON (use - for stdin) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose exactly one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch calendar send-lead-invite [-h] --provider {google,microsoft}
(--data-json DATA_JSON | --data-file DATA_FILE)
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch calendar update-event — Update a Lead-associated event with optional ETag protection
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Update a Lead-associated event with optional ETag protection. Available only when Calendar is enabled, with the caller's connected calendar and event ownership checks; read/write developer-key scopes apply.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: google, microsoft | |
--event-id | string; required | |
--data-json | json; input: json | UpdateEvent: one or more of title, description, start, end as JSON |
--data-file | file; input: file | Path to UpdateEvent: one or more of title, description, start, end JSON (use - for stdin) |
--expected-etag | string | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose exactly one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch calendar update-event [-h] --provider {google,microsoft}
--event-id EVENT_ID
(--data-json DATA_JSON | --data-file DATA_FILE)
[--expected-etag EXPECTED_ETAG]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]capabilities
autotouch capabilities — Discover API capabilities and product operations
Auth: optional. Stability: stable. Destructive: no.
Subcommands: show, operations.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
--representation | string; choices: compact, full | Server projection (default: compact for JSON, full for human output) |
--source | string; choices: live, bundled; default: "live" | Capability source (default: live server; bundled is explicit offline metadata) |
Choose at most one of: --select, --json-pointer.
autotouch capabilities show
autotouch capabilities operations list --surface research_table
autotouch capabilities operations get research_table.email_finderautotouch capabilities operations — Discover product-operation capabilities
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, get.
autotouch capabilities operations [-h] {list,get} ...autotouch capabilities operations get — Get one backend product-operation capability
Auth: optional. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
operation_id | string; required | Operation id, for example research_table.email_finder |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch capabilities operations get [-h] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
operation_idautotouch capabilities operations list — List backend product-operation capabilities
Auth: optional. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--surface | string | Filter by operation surface, for example research_table or crm |
--cli-status | string | Filter by operation cli_status |
--cli-available | boolean; when omitted=false; when present=true | Only show operations with a CLI binding |
--approval-required | boolean; when omitted=false; when present=true | Only show approval-gated operations |
--no-approval-required | boolean; when omitted=false; when present=true | Only show operations that do not require approval |
--executable-only | boolean; when omitted=false; when present=true | Only show operations with callable execution support |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --approval-required, --no-approval-required.
Choose at most one of: --select, --json-pointer.
autotouch capabilities operations list [-h] [--surface SURFACE]
[--cli-status CLI_STATUS]
[--cli-available]
[--approval-required | --no-approval-required]
[--executable-only]
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch capabilities show — Get machine-readable API capabilities
Auth: optional. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
--representation | string; choices: compact, full | Server projection (default: compact for JSON, full for human output) |
--source | string; choices: live, bundled | Capability source (default: live server; bundled is explicit offline metadata) |
Choose at most one of: --select, --json-pointer.
autotouch capabilities show [-h] [--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
[--representation {compact,full}]
[--source {live,bundled}]capacity
autotouch capacity — Inspect sender and task capacity
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: overview, channels, recommend.
Read the backend-owned Command Center capacity model for LinkedIn, provider email, personal email, and calls. These commands are read-only and require the tasks:read developer-key scope.
autotouch capacity overview --scope org --output json
autotouch capacity channels --scope me --output json
autotouch capacity overview --scope me --user-email rep@example.com --output json
autotouch capacity recommend --scope org --output jsonautotouch capacity channels — Summarize channel capacity and blockers
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--scope | string; choices: org, me; default: "org" | Capacity scope (default: org) |
--user-id | string | Target org user id for --scope me |
--user-email | string | Target org user email for --scope me |
--surface | string; choices: admin_command_center, sales_home; default: "admin_command_center" | Command Center surface model to read |
--date | string | Capacity date in YYYY-MM-DD; default is today in the requested timezone |
--timezone | string | IANA timezone for the date window, for example America/New_York |
--include-details | boolean; when omitted=false; when present=true | Also include raw channel details |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch capacity channels [-h] [--scope {org,me}] [--user-id USER_ID]
[--user-email USER_EMAIL]
[--surface {admin_command_center,sales_home}]
[--date DATE] [--timezone TIMEZONE]
[--include-details] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch capacity overview — Return the full Command Center overview payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--scope | string; choices: org, me; default: "org" | Capacity scope (default: org) |
--user-id | string | Target org user id for --scope me |
--user-email | string | Target org user email for --scope me |
--surface | string; choices: admin_command_center, sales_home; default: "admin_command_center" | Command Center surface model to read |
--date | string | Capacity date in YYYY-MM-DD; default is today in the requested timezone |
--timezone | string | IANA timezone for the date window, for example America/New_York |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch capacity overview [-h] [--scope {org,me}] [--user-id USER_ID]
[--user-email USER_EMAIL]
[--surface {admin_command_center,sales_home}]
[--date DATE] [--timezone TIMEZONE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch capacity recommend — Recommend the next capacity action from current usage
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--scope | string; choices: org, me; default: "org" | Capacity scope (default: org) |
--user-id | string | Target org user id for --scope me |
--user-email | string | Target org user email for --scope me |
--surface | string; choices: admin_command_center, sales_home; default: "admin_command_center" | Command Center surface model to read |
--date | string | Capacity date in YYYY-MM-DD; default is today in the requested timezone |
--timezone | string | IANA timezone for the date window, for example America/New_York |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch capacity recommend [-h] [--scope {org,me}]
[--user-id USER_ID]
[--user-email USER_EMAIL]
[--surface {admin_command_center,sales_home}]
[--date DATE] [--timezone TIMEZONE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]cells
autotouch cells — Cell operations
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: get, patch, schema.
autotouch cells [-h] {get,patch,schema} ...autotouch cells get — Get one cell with value/status/metadata
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--row-id | string; required | |
--column-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch cells get [-h] --row-id ROW_ID --column-id COLUMN_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch cells patch — Patch cells in batch
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Patch cells in batch. Use column key strings in updates[].key; this payload does not accept columnId.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--updates-json | json; input: json | JSON list or {updates:[...]} object |
--updates-file | file; input: file | Path to JSON file with updates payload |
--detect-types | boolean; when omitted=false; when present=true | Set detect_types=true query flag |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch cells patch [-h] --table-id TABLE_ID
[--updates-json UPDATES_JSON]
[--updates-file UPDATES_FILE] [--detect-types]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch cells schema — Print cell payload schemas
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, patch_updates; default: "all" | |
--out-file | file; input: file | Write schema JSON to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch cells schema [-h] [--type {all,patch_updates}]
[--out-file OUT_FILE]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]cli-manifest
autotouch cli-manifest — Print the machine-readable CLI command manifest
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--source | string; choices: live, bundled; default: "live" | Manifest source |
--out-file | file; input: file | Write manifest JSON to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch cli-manifest [-h] [--source {live,bundled}]
[--out-file OUT_FILE]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]cli-reference
autotouch cli-reference — Print the generated CLI reference
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--source | string; choices: live, bundled; default: "live" | Reference source |
--out-file | file; input: file | Write reference markdown to file |
--output | string; choices: json, ndjson, human; default: "human" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON when using JSON output |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch cli-reference [-h] [--source {live,bundled}]
[--out-file OUT_FILE]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]columns
autotouch columns — Column operations
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, create, update, hide, show, move, delete, projections, test-http-request, run, stop, run-next, estimate, test-classify, recipe.
autotouch columns [-h]
{list,create,update,hide,show,move,delete,projections,test-http-request,run,stop,run-next,estimate,test-classify,recipe}
...autotouch columns create — Create a column
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Create a column from a ColumnCreate payload. For llm_enrichment, there are two valid authoring paths: - generated path: send config.instructions and let the API compile config.advancedPrompt - manual path: send config.advancedPrompt directly when you want exact prompt control The saved/runtime contract is config.advancedPrompt; config.prompt and config.advanced_prompt are rejected.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--data-json | json; input: json | ColumnCreate payload JSON |
--data-file | file; input: file | ColumnCreate payload file path |
--position | number | Explicit numeric position override |
--after-column-id | string | Place the new column after this existing column id |
--before-column-id | string | Place the new column before this existing column id |
--research-mode | string; choices: lite, heavy | For LLM Research Agent columns, set config.researchMode. Omitted agent columns default to lite. |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
Recommended flow for llm_enrichment:
autotouch columns recipe --type llm_enrichment --output human
The runnable prompt is always config.advancedPrompt before execution.autotouch columns create [-h] --table-id TABLE_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE] [--position POSITION]
[--after-column-id AFTER_COLUMN_ID]
[--before-column-id BEFORE_COLUMN_ID]
[--research-mode {lite,heavy}]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch columns delete — Delete a column and all of its cells
Auth: developer_key_or_user_session. Stability: stable. Destructive: yes.
Output modes: json, ndjson, human.
Permanently remove one non-system Research Table column after explicit confirmation. Requires columns:write and table access. The definition is removed synchronously; active work is cancelled and stored cell cleanup can continue in the background. Use --yes only after the user has approved this exact table and column. Native Command Center deletion uses its own approval action.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-id | string; required | |
--yes | boolean; when omitted=false; when present=true | Required confirmation flag for destructive delete |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch columns delete --table-id <TABLE_ID> --column-id <COLUMN_ID> --yesautotouch columns estimate — Estimate a column run
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-id | string; required | |
--scope | string; choices: all, subset, row, firstN, filtered; default: "all" | Run scope: row=one explicit ID, subset=explicit many IDs, filtered=current filters, firstN=first N rows, all=entire table |
--row-id | string | Single row ID for scope=row |
--row-ids | list | Row IDs for subset scope (or a single row when scope=row) |
--first-n | integer | First N rows (for scope=firstN). Use with --unprocessed-only to process the next rows without reruns |
--unprocessed-only | boolean; when omitted=true; when present=true | Only process rows without values (default) |
--include-processed | boolean; when omitted=true; when present=false | Include rows that already have output |
--filters-json | json; input: json | JSON object for scope=filtered |
--filters-file | file; input: file | Path to JSON file for scope=filtered |
--data-json | json; input: json | Explicit RunRequest payload JSON (overrides scope flags) |
--data-file | file; input: file | Path to RunRequest payload JSON file (overrides scope flags) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --unprocessed-only, --include-processed.
Choose at most one of: --select, --json-pointer.
autotouch columns estimate [-h] --table-id TABLE_ID --column-id
COLUMN_ID
[--scope {all,subset,row,firstN,filtered}]
[--row-id ROW_ID] [--row-ids [ROW_IDS ...]]
[--first-n FIRST_N]
[--unprocessed-only | --include-processed]
[--filters-json FILTERS_JSON]
[--filters-file FILTERS_FILE]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch columns hide — Hide a column without deleting its cells
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Hide a column from the default table view. This is reversible and does not delete cells. Use columns delete only when you intentionally want to remove the column and its data.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch columns hide [-h] --table-id TABLE_ID --column-id COLUMN_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch columns list — List table columns
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch columns list [-h] --table-id TABLE_ID [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch columns move — Reorder an existing column relative to neighbors
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Move an existing column by supplying neighbor column ids. Prefer sending both neighbors when possible for stable placement.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-id | string; required | |
--after-column-id | string | Place the column after this existing column id |
--before-column-id | string | Place the column before this existing column id |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch columns move [-h] --table-id TABLE_ID --column-id COLUMN_ID
[--after-column-id AFTER_COLUMN_ID]
[--before-column-id BEFORE_COLUMN_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch columns projections — Create JSON projection columns
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Create JSON-split projection columns from a JSON source column. Use this command for flattening enrichment JSON output into readable columns. Do not use `autotouch columns create` with `kind: "projection"` and empty `config`.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--data-json | json; input: json | CreateProjectionsRequest payload JSON |
--data-file | file; input: file | CreateProjectionsRequest payload file path |
--after-column-id | string | Place the new projection group after this existing column id |
--before-column-id | string | Place the new projection group before this existing column id |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
CreateProjectionsRequest payload example:
{
"items": [
{
"key": "company_name",
"label": "Company Name",
"sourceColumnId": "<JSON_COLUMN_ID>",
"path": "company_name",
"dataType": "text"
}
]
}
Each item must include `key`, `label`, `sourceColumnId`, and `path`.autotouch columns projections [-h] --table-id TABLE_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--after-column-id AFTER_COLUMN_ID]
[--before-column-id BEFORE_COLUMN_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch columns recipe — Print copy-ready ColumnCreate payload templates
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, person_lookup, linkedin_profile_lookup, formatter, classify, llm_enrichment, email_finder, phone_finder, add_to_crm, promote_company, sync_to_table, add_to_sequence, crm_push, outreach_push, http_request, company_lookup, fit_analysis, to_leads, to_sequence, to_crm, to_outreach, add_to_leads, sync_to_leads, sync_to_leads_array, add_to_leads_array; default: "all" | |
--research-mode | string; choices: lite, heavy; default: "lite" | Research Agent depth for LLM recipes (default: lite; heavy costs more per row) |
--out-file | file; input: file | Write template JSON to file (single type writes payload only) |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch columns recipe [-h]
[--type {all,person_lookup,linkedin_profile_lookup,formatter,classify,llm_enrichment,email_finder,phone_finder,add_to_crm,promote_company,sync_to_table,add_to_sequence,crm_push,outreach_push,http_request,company_lookup,fit_analysis,to_leads,to_sequence,to_crm,to_outreach,add_to_leads,sync_to_leads,sync_to_leads_array,add_to_leads_array}]
[--research-mode {lite,heavy}]
[--out-file OUT_FILE]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch columns run — Run a column
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human. Supports streaming progress.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-id | string; required | |
--scope | string; choices: all, subset, row, firstN, filtered; default: "all" | Run scope: row=one explicit ID, subset=explicit many IDs, filtered=current filters, firstN=first N rows, all=entire table |
--row-id | string | Single row ID for scope=row |
--row-ids | list | Row IDs for subset scope (or a single row when scope=row) |
--first-n | integer | First N rows (for scope=firstN). Use with --unprocessed-only to process the next rows without reruns |
--unprocessed-only | boolean; when omitted=true; when present=true | Only process rows without values (default) |
--include-processed | boolean; when omitted=true; when present=false | Include rows that already have output |
--filters-json | json; input: json | JSON object for scope=filtered |
--filters-file | file; input: file | Path to JSON file for scope=filtered |
--data-json | json; input: json | Explicit RunRequest payload JSON (overrides scope flags) |
--data-file | file; input: file | Path to RunRequest payload JSON file (overrides scope flags) |
--show-estimate | boolean; when omitted=false; when present=true | Include estimate response in output |
--dry-run | boolean; when omitted=false; when present=true | Only estimate; do not execute run |
--max-credits | number | Block run when estimate exceeds this value |
--allow-unknown-max | boolean; when omitted=false; when present=true | Allow run when estimated_credits_max is null (max-credits guard uses min estimate) |
--wait | boolean; when omitted=false; when present=true | Wait for the canonical operation-run terminal status by polling /api/operation-runs/{operation_run_id} |
--quiet-wait | boolean; when omitted=false; when present=true | Suppress per-poll output in --wait mode |
--poll-interval | integer; default: 2 | Polling interval seconds for --wait |
--wait-timeout | integer; default: 0 | Max seconds to wait (0 = no timeout) |
--fail-on-error | boolean; when omitted=false; when present=true | Exit non-zero when final status is error/cancelled |
--fail-on-partial | boolean; when omitted=false; when present=true | Exit non-zero when final status is partial |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --unprocessed-only, --include-processed.
Choose at most one of: --select, --json-pointer.
autotouch columns run [-h] --table-id TABLE_ID --column-id COLUMN_ID
[--scope {all,subset,row,firstN,filtered}]
[--row-id ROW_ID] [--row-ids [ROW_IDS ...]]
[--first-n FIRST_N]
[--unprocessed-only | --include-processed]
[--filters-json FILTERS_JSON]
[--filters-file FILTERS_FILE]
[--data-json DATA_JSON] [--data-file DATA_FILE]
[--show-estimate] [--dry-run]
[--max-credits MAX_CREDITS] [--allow-unknown-max]
[--wait] [--quiet-wait]
[--poll-interval POLL_INTERVAL]
[--wait-timeout WAIT_TIMEOUT] [--fail-on-error]
[--fail-on-partial] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch columns run-next — Run up to N selected rows using subset scope
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human. Supports streaming progress.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-id | string; required | |
--count | integer; required | Maximum number of rows to queue |
--filters-json | json; input: json | Optional JSON object to select from filtered rows |
--filters-file | file; input: file | Optional JSON file to select from filtered rows |
--page-size | integer; default: 200 | Rows page size while selecting candidates (max 1000) |
--include-processed | boolean; when omitted=true; when present=false | Include rows that already have output in candidate selection |
--fail-if-empty | boolean; when omitted=false; when present=true | Exit non-zero when no eligible rows are selected |
--show-estimate | boolean; when omitted=false; when present=true | Include estimate response in output |
--dry-run | boolean; when omitted=false; when present=true | Only estimate; do not execute run |
--max-credits | number | Block run when estimate exceeds this value |
--allow-unknown-max | boolean; when omitted=false; when present=true | Allow run when estimated_credits_max is null (max-credits guard uses min estimate) |
--wait | boolean; when omitted=false; when present=true | Wait for the canonical operation-run terminal status by polling /api/operation-runs/{operation_run_id} |
--quiet-wait | boolean; when omitted=false; when present=true | Suppress per-poll output in --wait mode |
--poll-interval | integer; default: 2 | Polling interval seconds for --wait |
--wait-timeout | integer; default: 0 | Max seconds to wait (0 = no timeout) |
--fail-on-error | boolean; when omitted=false; when present=true | Exit non-zero when final status is error/cancelled |
--fail-on-partial | boolean; when omitted=false; when present=true | Exit non-zero when final status is partial |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch columns run-next [-h] --table-id TABLE_ID --column-id
COLUMN_ID --count COUNT
[--filters-json FILTERS_JSON]
[--filters-file FILTERS_FILE]
[--page-size PAGE_SIZE]
[--include-processed] [--fail-if-empty]
[--show-estimate] [--dry-run]
[--max-credits MAX_CREDITS]
[--allow-unknown-max] [--wait]
[--quiet-wait]
[--poll-interval POLL_INTERVAL]
[--wait-timeout WAIT_TIMEOUT]
[--fail-on-error] [--fail-on-partial]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch columns show — Show a previously hidden column
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Make a hidden column visible in the table schema again.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch columns show [-h] --table-id TABLE_ID --column-id COLUMN_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch columns stop — Stop a running column (cancel active job dispatch)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch columns stop [-h] --table-id TABLE_ID --column-id COLUMN_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch columns test-classify — Preview Jev classification on one saved row without cell writes or credits
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--data-json | json; input: json | JSON object containing config and row_id |
--data-file | file; input: file | File containing config and row_id |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch columns test-classify [-h] --table-id TABLE_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch columns test-http-request — Preview an HTTP Request column against the first table row
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Resolve and execute one HTTP request using the first row in the table. This preview does not write cells. Pass either a full http_request column payload or a direct request config object.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--data-json | json; input: json | HTTP request column payload JSON or direct preview payload JSON |
--data-file | file; input: file | HTTP request column payload file path or direct preview payload file path |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
Recommended flow:
autotouch columns recipe --type http_request --out-file column.json
autotouch columns test-http-request --table-id <TABLE_ID> --data-file column.json
autotouch columns create --table-id <TABLE_ID> --data-file column.json
Template syntax:
- {{column_key}} -> row value from the first table row
- {{secrets.name}} -> workspace secret or active org integration credential by provider slugautotouch columns test-http-request --table-id <TABLE_ID> --data-file column.jsonautotouch columns update — Update a column
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Update a column definition. Nested config keys merge into the existing config, so partial config patches are supported. ColumnUpdate JSON can patch valueSchema metadata, including enum/open_enum options for select-like filtering.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-id | string; required | |
--data-json | json; input: json | ColumnUpdate payload JSON, including valueSchema enum/open_enum metadata when needed |
--data-file | file; input: file | ColumnUpdate payload file path, including valueSchema enum/open_enum metadata when needed |
--position | number | Explicit numeric position override |
--hide | boolean; when omitted=false; when present=true | Hide the column without deleting its cells |
--show | boolean; when omitted=false; when present=true | Show a previously hidden column |
--research-mode | string; choices: lite, heavy | Set config.researchMode. Include config.mode=agent when switching a Quick LLM column to Research Agent. |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --hide, --show.
Choose at most one of: --select, --json-pointer.
autotouch columns update [-h] --table-id TABLE_ID --column-id COLUMN_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE] [--position POSITION]
[--hide | --show]
[--research-mode {lite,heavy}]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]companies
autotouch companies — Company workspace operations
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: promote, refresh-firmographics, refresh-firmographics-status, list, create, import-csv, import-status, delete, custom-fields, signals.
autotouch companies list --search Acme --limit 25
autotouch companies create --name Acme --domain acme.com
autotouch companies import-csv --file accounts.csv --source-label Q3-targets
autotouch companies delete --company-id <COMPANY_ID> --yes
autotouch companies custom-fields set --company-id <COMPANY_ID> --field-key account_tier --value strategic
autotouch companies custom-fields bulk-set --company-id <COMPANY_ID> --field-key account_tier --value strategic
autotouch companies signals enroll --company-id <COMPANY_ID> --signal-type hiring --signal-type fundingautotouch companies create — Create or promote a company account
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Company create payload JSON |
--data-file | file; input: file | Path to company create payload JSON |
--name | string | |
--domain | string | |
--industry | string | |
--employee-count | string | |
--location | string | |
--city | string | |
--state | string | |
--country | string | |
--zip-code | string | |
--timezone | string | |
--phone | string | |
--linkedin-url | string | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch companies create [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE] [--name NAME]
[--domain DOMAIN] [--industry INDUSTRY]
[--employee-count EMPLOYEE_COUNT]
[--location LOCATION] [--city CITY]
[--state STATE] [--country COUNTRY]
[--zip-code ZIP_CODE] [--timezone TIMEZONE]
[--phone PHONE]
[--linkedin-url LINKEDIN_URL]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch companies custom-fields — Set company custom field values
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: set, bulk-set.
autotouch companies custom-fields [-h] {set,bulk-set} ...autotouch companies custom-fields bulk-set — Set one custom field value on selected companies
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--company-id | string; repeatable; comma-separated | Company id (repeatable; comma-separated also supported) |
--company-ids-json | json; input: json | JSON array or object with company_ids[] |
--company-ids-file | file; input: file | Path to JSON file with company_ids[] |
--data-json | json; input: json | Explicit custom field payload JSON |
--data-file | file; input: file | Path to custom field payload JSON file |
--field-key | string | Custom field key from `autotouch crm fields list`, not label or id |
--value | string; sensitive | String value to write |
--value-json | json; input: json | Typed JSON value to write |
--value-file | file; input: file | Path to JSON value to write |
--clear | boolean; when omitted=false; when present=true | Clear the custom field value |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --value, --value-json, --value-file, --clear.
Choose at most one of: --select, --json-pointer.
autotouch companies custom-fields bulk-set [-h]
[--company-id COMPANY_ID]
[--company-ids-json COMPANY_IDS_JSON]
[--company-ids-file COMPANY_IDS_FILE]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--field-key FIELD_KEY]
[--value VALUE | --value-json VALUE_JSON | --value-file VALUE_FILE | --clear]
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch companies custom-fields set — Set one custom field value on one company
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--company-id | string; required | |
--data-json | json; input: json | Explicit custom field payload JSON |
--data-file | file; input: file | Path to custom field payload JSON file |
--field-key | string | Custom field key from `autotouch crm fields list`, not label or id |
--value | string; sensitive | String value to write |
--value-json | json; input: json | Typed JSON value to write |
--value-file | file; input: file | Path to JSON value to write |
--clear | boolean; when omitted=false; when present=true | Clear the custom field value |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --value, --value-json, --value-file, --clear.
Choose at most one of: --select, --json-pointer.
autotouch companies custom-fields set [-h] --company-id COMPANY_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--field-key FIELD_KEY]
[--value VALUE | --value-json VALUE_JSON | --value-file VALUE_FILE | --clear]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch companies delete — Remove selected promoted companies from the Companies workspace
Auth: developer_key_or_user_session. Stability: stable. Destructive: yes.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit CompanySelection payload JSON |
--data-file | file; input: file | Path to explicit CompanySelection payload JSON |
--company-id | string; repeatable; comma-separated | Company id; repeatable or comma-separated |
--company-ids-json | json; input: json | JSON array or object with company_ids[] |
--company-ids-file | file; input: file | Path to JSON file with company_ids[] |
--yes | boolean; when omitted=false; when present=true | Required confirmation for workspace removal |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch companies delete [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--company-id COMPANY_ID]
[--company-ids-json COMPANY_IDS_JSON]
[--company-ids-file COMPANY_IDS_FILE]
[--yes] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch companies import-csv — Import a CSV into promoted Companies/accounts
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--file | file; required; input: file | Path to the source CSV |
--source-label | string | |
--core-field-mappings-json | json; input: json | |
--core-field-mappings-file | file; input: file | |
--custom-field-mappings-json | json; input: json | |
--custom-field-mappings-file | file; input: file | |
--custom-field-static-values-json | json; input: json | |
--custom-field-static-values-file | file; input: file | |
--sync | boolean; when omitted=false; when present=true | Run synchronously instead of queueing |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch companies import-csv [-h] --file FILE
[--source-label SOURCE_LABEL]
[--core-field-mappings-json CORE_FIELD_MAPPINGS_JSON]
[--core-field-mappings-file CORE_FIELD_MAPPINGS_FILE]
[--custom-field-mappings-json CUSTOM_FIELD_MAPPINGS_JSON]
[--custom-field-mappings-file CUSTOM_FIELD_MAPPINGS_FILE]
[--custom-field-static-values-json CUSTOM_FIELD_STATIC_VALUES_JSON]
[--custom-field-static-values-file CUSTOM_FIELD_STATIC_VALUES_FILE]
[--sync] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch companies import-status — Get company CSV import status
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch companies import-status [-h] --task-id TASK_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch companies list — Query Companies workspace records
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--search | string | |
--owner-id | string | |
--source-table-id | string | Restrict results to companies from a Research Table |
--filters-json | json; input: json | JSON company filter rules |
--filters-file | file; input: file | Path to JSON company filter rules |
--qualified-only | boolean; when omitted=false; when present=true | |
--include-memory | boolean; when omitted=false; when present=true | |
--sort | string; default: "name" | |
--order | string; choices: asc, desc; default: "asc" | |
--limit | integer; default: 100 | |
--offset | integer; default: 0 | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch companies list [-h] [--search SEARCH] [--owner-id OWNER_ID]
[--source-table-id SOURCE_TABLE_ID]
[--filters-json FILTERS_JSON]
[--filters-file FILTERS_FILE]
[--qualified-only] [--include-memory]
[--sort SORT] [--order {asc,desc}]
[--limit LIMIT] [--offset OFFSET]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch companies promote — Promote one exact Company memory record into Companies
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Promote one exact Company memory record into Companies. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
--company-id | string; required | |
--data-json | json; input: json | Optional research context: research {table_id, row_id, source_fit_column_id} as JSON |
--data-file | file; input: file | Path to Optional research context: research {table_id, row_id, source_fit_column_id} JSON (use - for stdin) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch companies promote [-h] --company-id COMPANY_ID
[--data-json DATA_JSON | --data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch companies refresh-firmographics — Refresh firmographics for one exact Company memory record
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Refresh firmographics for one exact Company memory record. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
--company-id | string; required | |
--data-json | json; input: json | CompanyFirmographicsRefreshPayload: optional providers, use_geocoder, classify_public_docs as JSON |
--data-file | file; input: file | Path to CompanyFirmographicsRefreshPayload: optional providers, use_geocoder, classify_public_docs JSON (use - for stdin) |
--idempotency-key | string | Optional stable refresh occurrence key, sent as Idempotency-Key |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch companies refresh-firmographics [-h] --company-id COMPANY_ID
[--data-json DATA_JSON | --data-file DATA_FILE]
[--idempotency-key IDEMPOTENCY_KEY]
[--base-url BASE_URL]
[--token TOKEN]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch companies refresh-firmographics-status — Read the exact native firmographic refresh result
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Read the exact native firmographic refresh result. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
--company-id | string; required | |
--job-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch companies refresh-firmographics-status [-h] --company-id
COMPANY_ID --job-id
JOB_ID
[--base-url BASE_URL]
[--token TOKEN]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch companies signals — Manage recurring Company Signals monitoring
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: enroll.
autotouch companies signals [-h] {enroll} ...autotouch companies signals enroll — Enroll selected companies in recurring signal monitoring
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Enroll selected companies using the provider's company-monitoring contract. LinkedIn posts uses harvest_linkedin with linkedin_posts, a daily cadence, and a one-day retrieval window. Relevance is evaluated after retrieval; custom topics do not become provider search keywords. Enrollment requests an immediate check by default; --no-run-now waits for the next scheduled cadence.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit bulk-enrollment payload JSON, including ids or descriptor selection |
--data-file | file; input: file | Path to an explicit bulk-enrollment payload JSON file |
--company-id | string; repeatable; comma-separated | Company id (repeatable; comma-separated also supported) |
--company-ids-json | json; input: json | JSON array or object with company_ids[] |
--company-ids-file | file; input: file | Path to JSON file with company_ids[] |
--provider | string; default: "signalbase" | Company monitoring provider (default: signalbase); use harvest_linkedin for LinkedIn posts |
--signal-type | string; repeatable; comma-separated | Signal type (repeatable; comma-separated also supported); omission uses the selected provider's defaults. harvest_linkedin supports linkedin_posts only |
--frequency | string; default: "weekly" | Requested cadence (default: weekly); LinkedIn posts always runs daily |
--lookback-days | integer; default: 7 | Requested lookback in days (default: 7); LinkedIn posts always retrieves one day |
--delivery-channel | string; repeatable; comma-separated | Delivery channel (repeatable; comma-separated also supported) |
--active-until | string | Optional ISO-8601 subscription end time |
--paused | boolean; when omitted=false; when present=true | Create subscriptions paused without running now |
--run-now, --no-run-now | string | Request an immediate asynchronous check (default for enabled enrollment); --no-run-now only enrolls |
--config-json | json; input: json | Provider config JSON containing signal_filters. LinkedIn posts uses signal_filters.linkedin_posts with relevance_mode=recommended|custom|all; custom requires a topic |
--config-file | file; input: file | Path to provider config JSON containing signal_filters |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch companies signals enroll --company-id <COMPANY_ID> --signal-type funding
autotouch companies signals enroll --company-id <COMPANY_ID> --provider harvest_linkedin --signal-type linkedin_posts --frequency daily --lookback-days 1 --config-json '{"signal_filters":{"linkedin_posts":{"relevance_mode":"custom","topic":"medical devices and related work"}}}'context
autotouch context — Resolved requester context used by enrichment/runtime
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: resolved.
autotouch context [-h] {resolved} ...autotouch context resolved — Show effective requester context after workspace profile and personal voice resolution
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch context resolved [-h] [--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]crm
autotouch crm — CRM workspace field catalog and custom fields
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: fields.
autotouch crm fields list --entity lead --custom-only
autotouch crm fields create --entity lead --label Priority --type select --option high=High --option low=Low
autotouch crm fields update --field-id <FIELD_ID> --label 'Lead priority'autotouch crm fields — CRM Lead, Company, and Deal field catalog
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, create, update.
autotouch crm fields [-h] {list,create,update} ...autotouch crm fields create — Create a Lead, Company, or Deal custom field definition
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit CRM custom field payload JSON |
--data-file | file; input: file | Path to CRM custom field payload JSON file |
--entity | string; choices: lead, company, deal | Custom field entity type |
--key | string | Optional stable snake_case key; derived from label when omitted |
--type | string; choices: text, number, date, boolean, select, multi_select | Custom field data type |
--label | string | Custom field display label |
--option | string; repeatable | Select option as VALUE=Label or VALUE=Label:#hex; repeat for select/multi_select fields |
--options-json | json; input: json | JSON array of option objects |
--options-file | file; input: file | Path to JSON array of option objects |
--filterable | boolean; when omitted=null; when present=true | |
--not-filterable | boolean; when omitted=null; when present=false | |
--sortable | boolean; when omitted=null; when present=true | |
--not-sortable | boolean; when omitted=null; when present=false | |
--searchable | boolean; when omitted=null; when present=true | |
--not-searchable | boolean; when omitted=null; when present=false | |
--include-in-sequence-variables | boolean; when omitted=null; when present=true | |
--exclude-from-sequence-variables | boolean; when omitted=null; when present=false | |
--include-in-task-context | boolean; when omitted=null; when present=true | |
--exclude-from-task-context | boolean; when omitted=null; when present=false | |
--include-in-ai-context | boolean; when omitted=null; when present=true | |
--exclude-from-ai-context | boolean; when omitted=null; when present=false | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --filterable, --not-filterable.
Choose at most one of: --sortable, --not-sortable.
Choose at most one of: --searchable, --not-searchable.
Choose at most one of: --include-in-sequence-variables, --exclude-from-sequence-variables.
Choose at most one of: --include-in-task-context, --exclude-from-task-context.
Choose at most one of: --include-in-ai-context, --exclude-from-ai-context.
Choose at most one of: --select, --json-pointer.
autotouch crm fields create [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--entity {lead,company,deal}] [--key KEY]
[--type {text,number,date,boolean,select,multi_select}]
[--label LABEL] [--option OPTION]
[--options-json OPTIONS_JSON]
[--options-file OPTIONS_FILE]
[--filterable | --not-filterable]
[--sortable | --not-sortable]
[--searchable | --not-searchable]
[--include-in-sequence-variables | --exclude-from-sequence-variables]
[--include-in-task-context | --exclude-from-task-context]
[--include-in-ai-context | --exclude-from-ai-context]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch crm fields list — List standard and custom CRM fields
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--entity | string; choices: lead, company, deal | Filter by Lead, Company, or Deal fields |
--usage | string; choices: profile, table, sync_to_leads, filter, sort, search, task_context, sequence_variables, ai_context | Filter field catalog by usage |
--custom-only | boolean; when omitted=false; when present=true | Return only organization-defined custom fields |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch crm fields list [-h] [--entity {lead,company,deal}]
[--usage {profile,table,sync_to_leads,filter,sort,search,task_context,sequence_variables,ai_context}]
[--custom-only] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch crm fields update — Update a CRM custom field definition
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--field-id | string; required | Custom field definition id from crm fields list |
--data-json | json; input: json | Explicit CRM custom field payload JSON |
--data-file | file; input: file | Path to CRM custom field payload JSON file |
--label | string | Custom field display label |
--option | string; repeatable | Select option as VALUE=Label or VALUE=Label:#hex; repeat for select/multi_select fields |
--options-json | json; input: json | JSON array of option objects |
--options-file | file; input: file | Path to JSON array of option objects |
--filterable | boolean; when omitted=null; when present=true | |
--not-filterable | boolean; when omitted=null; when present=false | |
--sortable | boolean; when omitted=null; when present=true | |
--not-sortable | boolean; when omitted=null; when present=false | |
--searchable | boolean; when omitted=null; when present=true | |
--not-searchable | boolean; when omitted=null; when present=false | |
--include-in-sequence-variables | boolean; when omitted=null; when present=true | |
--exclude-from-sequence-variables | boolean; when omitted=null; when present=false | |
--include-in-task-context | boolean; when omitted=null; when present=true | |
--exclude-from-task-context | boolean; when omitted=null; when present=false | |
--include-in-ai-context | boolean; when omitted=null; when present=true | |
--exclude-from-ai-context | boolean; when omitted=null; when present=false | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --filterable, --not-filterable.
Choose at most one of: --sortable, --not-sortable.
Choose at most one of: --searchable, --not-searchable.
Choose at most one of: --include-in-sequence-variables, --exclude-from-sequence-variables.
Choose at most one of: --include-in-task-context, --exclude-from-task-context.
Choose at most one of: --include-in-ai-context, --exclude-from-ai-context.
Choose at most one of: --select, --json-pointer.
autotouch crm fields update [-h] --field-id FIELD_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE] [--label LABEL]
[--option OPTION]
[--options-json OPTIONS_JSON]
[--options-file OPTIONS_FILE]
[--filterable | --not-filterable]
[--sortable | --not-sortable]
[--searchable | --not-searchable]
[--include-in-sequence-variables | --exclude-from-sequence-variables]
[--include-in-task-context | --exclude-from-task-context]
[--include-in-ai-context | --exclude-from-ai-context]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]deals
autotouch deals — Deal workspace operations
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, get, pipelines, create, update, delete.
autotouch deals [-h] {list,get,pipelines,create,update,delete} ...autotouch deals create — Create a Deal (deals:write)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Create a Deal (deals:write)
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | DealCreate: required name; optional paired pipeline_id and stage_id, company/lead IDs, owner, amount, close dates, next step and custom fields as JSON |
--data-file | file; input: file | Path to DealCreate: required name; optional paired pipeline_id and stage_id, company/lead IDs, owner, amount, close dates, next step and custom fields JSON (use - for stdin) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose exactly one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch deals create [-h]
(--data-json DATA_JSON | --data-file DATA_FILE)
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch deals delete — Archive one Deal (deals:write); the API returns 204 and the CLI prints a local confirmation
Auth: developer_key_or_user_session. Stability: stable. Destructive: yes.
Output modes: json, ndjson, human.
Archive one Deal (deals:write); the API returns 204 and the CLI prints a local confirmation
| Argument | Contract | Description |
|---|---|---|
--deal-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch deals delete [-h] --deal-id DEAL_ID [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch deals get — Read one Deal by ID (deals:read)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Read one Deal by ID (deals:read)
| Argument | Contract | Description |
|---|---|---|
--deal-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch deals get [-h] --deal-id DEAL_ID [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch deals list — List Deals with optional filters and page offset (deals:read)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
List Deals with optional filters and page offset (deals:read)
| Argument | Contract | Description |
|---|---|---|
--company-id | string | |
--lead-id | string | |
--owner-user-id | string | |
--pipeline-id | string | |
--stage-id | string | |
--state | string; choices: open, won, lost, unknown | |
--q | string | |
--include-archived | boolean; when omitted=null; when present=true | |
--limit | integer | |
--skip | integer | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch deals list [-h] [--company-id COMPANY_ID] [--lead-id LEAD_ID]
[--owner-user-id OWNER_USER_ID]
[--pipeline-id PIPELINE_ID] [--stage-id STAGE_ID]
[--state {open,won,lost,unknown}] [--q Q]
[--include-archived] [--limit LIMIT] [--skip SKIP]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch deals pipelines — List available Deal pipelines and stages (deals:read)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
List available Deal pipelines and stages (deals:read)
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch deals pipelines [-h] [--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch deals update — Update a Deal, including stage and next step (deals:write)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Update a Deal, including stage and next step (deals:write)
| Argument | Contract | Description |
|---|---|---|
--deal-id | string; required | |
--data-json | json; input: json | DealUpdate: changed Deal fields; pipeline/stage changes can trigger lifecycle effects as JSON |
--data-file | file; input: file | Path to DealUpdate: changed Deal fields; pipeline/stage changes can trigger lifecycle effects JSON (use - for stdin) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose exactly one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch deals update [-h] --deal-id DEAL_ID
(--data-json DATA_JSON | --data-file DATA_FILE)
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]event-streams
autotouch event-streams — Configure Research Table event streams
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, setup, save, suggest-mappings, generate-settings, reprocess.
autotouch event-streams [-h]
{list,setup,save,suggest-mappings,generate-settings,reprocess}
...autotouch event-streams generate-settings — Generate display and mapping settings
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
--data-json | json; input: json | |
--data-file | file; input: file |
Choose at most one of: --select, --json-pointer.
autotouch event-streams generate-settings [-h] [--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
[--data-json DATA_JSON]
[--data-file DATA_FILE]autotouch event-streams list — List event-stream definitions
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
--table-id | string |
Choose at most one of: --select, --json-pointer.
autotouch event-streams list [-h] [--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose] [--table-id TABLE_ID]autotouch event-streams reprocess — Reprocess matching historical rows
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
definition_id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
--limit | integer; default: 500 | |
--data-json | json; input: json | |
--data-file | file; input: file |
Choose at most one of: --select, --json-pointer.
autotouch event-streams reprocess [-h] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose] [--limit LIMIT]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
definition_idautotouch event-streams save — Create or update one stream definition
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
--data-json | json; input: json | |
--data-file | file; input: file |
Choose at most one of: --select, --json-pointer.
autotouch event-streams save [-h] [--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose] [--data-json DATA_JSON]
[--data-file DATA_FILE]autotouch event-streams setup — Create or configure an event table from a setup plan
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
--data-json | json; input: json | |
--data-file | file; input: file | |
--idempotency-key | string | Retry-safe identity required when setup_mode is new_event_table |
Choose at most one of: --select, --json-pointer.
autotouch event-streams setup [-h] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--idempotency-key IDEMPOTENCY_KEY]autotouch event-streams suggest-mappings — Suggest mappings from sample fields
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
--data-json | json; input: json | |
--data-file | file; input: file |
Choose at most one of: --select, --json-pointer.
autotouch event-streams suggest-mappings [-h] [--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
[--data-json DATA_JSON]
[--data-file DATA_FILE]integrations
autotouch integrations — Discover connected sources/destinations and CRM import/push helpers
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, status, recipe, from-crm, from-crm-status, to-crm-status.
Use this before choosing a workflow. Directional vocabulary: from_crm pulls HubSpot/Attio/Salesforce into a research table; to_crm pushes rows to HubSpot/Attio; to_outreach pushes rows to Instantly/Smartlead; to_leads syncs rows to Autotouch Leads; to_sequence enrolls Leads into Autotouch Sequences.
autotouch integrations list
autotouch integrations status --provider hubspot
autotouch integrations recipe --type from_crm --provider hubspot
autotouch columns recipe --type to_crm --out-file push-to-crm.json
autotouch integrations to-crm-status --task-id <TASK_ID>autotouch integrations from-crm — Import a connected CRM selection into a Research Table
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Submit a HubSpot, Attio, or Salesforce list/filter import through the durable connected-CRM import command.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: hubspot, attio, salesforce | |
--list-id | string; required | Provider list id, or filters for a filter import |
--import-type | string; default: "company" | Provider object type |
--selected-field | string; repeatable; comma-separated | Provider property id (repeatable; comma-separated also supported) |
--filters-json | json; input: json | Provider filter descriptor array as JSON |
--filters-file | file; input: file | Path to a provider filter descriptor JSON array |
--table-mode | string; choices: create, append; default: "create" | |
--table-id | string | Existing Research Table id for append mode |
--table-name | string | Destination table name for create mode |
--data-json | json; input: json | Explicit import body JSON; overrides body flags |
--data-file | file; input: file | Path to explicit import body JSON; overrides body flags |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch integrations from-crm --provider hubspot --list-id <LIST_ID> --selected-field name --selected-field domain --table-name 'HubSpot Accounts'
autotouch integrations from-crm --provider salesforce --list-id filters --data-file salesforce-import.jsonautotouch integrations from-crm-status — Check a CRM import job
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Check a CRM import task created by POST /api/crm/{provider}/lists/{list_id}/import.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch integrations from-crm-status --task-id <TASK_ID>autotouch integrations list — List available source/destination integrations
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Read the backend-owned integration catalog. The response includes sources, destinations, and recipes. Use sources for pull workflows such as from_crm, and destinations for push/sync/enroll workflows such as to_crm, to_outreach, to_leads, and to_sequence.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch integrations list --output json
autotouch integrations list --select sources
autotouch integrations list --select destinationsautotouch integrations recipe — Print integration workflow payload recipes
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Print payload guidance without executing an integration workflow. For from_crm, use integrations from-crm to submit the generated path/body through the shared API command.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: from_crm; default: "from_crm" | |
--provider | string; choices: hubspot, attio, salesforce; default: "hubspot" | |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch integrations recipe --type from_crm --provider hubspot
autotouch integrations recipe --type from_crm --provider attio --output json --compactautotouch integrations status — Show connection status for one integration
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Read one provider from the integration catalog. The result shows connected/status/supports so agents can decide whether the provider can be used for from_crm, to_crm, or to_outreach before creating workflow columns.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: hubspot, attio, salesforce, instantly, smartlead | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch integrations status --provider hubspot
autotouch integrations status --provider instantly --select connected
autotouch integrations status --provider attio --select supportsautotouch integrations to-crm-status — Check a CRM push job
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Check a CRM push task created by running a research-table to_crm column.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch integrations to-crm-status --task-id <TASK_ID>jobs
autotouch jobs — Bulk job operations
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: get, list, watch.
autotouch jobs [-h] {get,list,watch} ...autotouch jobs get — Get bulk job details
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--job-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch jobs get [-h] --job-id JOB_ID [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch jobs list — List recent bulk jobs (recover latest job_id)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string | Filter by table id |
--column-id | string | Filter by column id |
--status | string; comma-separated | Filter by status (or comma-separated statuses) |
--provider | string | Filter by provider |
--limit | integer; default: 20 | Max jobs to return (1-100) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch jobs list [-h] [--table-id TABLE_ID] [--column-id COLUMN_ID]
[--status STATUS] [--provider PROVIDER]
[--limit LIMIT] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch jobs watch — Poll bulk job status until terminal (or once)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human. Supports streaming progress.
| Argument | Contract | Description |
|---|---|---|
--job-id | string; required | |
--once | boolean; when omitted=false; when present=true | Fetch once and exit |
--interval | integer; default: 2 | Polling interval seconds |
--wait-timeout | integer; default: 0 | Max seconds to wait (0 = no timeout) |
--fail-on-error | boolean; when omitted=false; when present=true | Exit non-zero on error/cancelled |
--fail-on-partial | boolean; when omitted=false; when present=true | Exit non-zero on partial |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch jobs watch [-h] --job-id JOB_ID [--once]
[--interval INTERVAL]
[--wait-timeout WAIT_TIMEOUT] [--fail-on-error]
[--fail-on-partial] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]leads
autotouch leads — Lead query + mutation operations
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: recipe, get, custom-fields, create, update, upsert-contact-channels, update-status, reassign-owner, find-emails, find-mobile-numbers, validate-emails, exit-sequences, create-research-table, import-csv, import-preview, import-status, delete, query, count, stats, research, filters-metadata, research-tables.
autotouch leads [-h]
{recipe,get,custom-fields,create,update,upsert-contact-channels,upsert-contacts,update-status,reassign-owner,find-emails,find-mobile-numbers,validate-emails,exit-sequences,create-research-table,import-csv,import-preview,import-status,delete,query,count,stats,research,filters-metadata,research-tables}
...autotouch leads count — Count leads matching a query payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit leads query payload JSON |
--data-file | file; input: file | Path to leads query payload JSON file |
--filter-json | json; input: json | Filter descriptor JSON object |
--filter-file | file; input: file | Path to filter descriptor JSON file |
--sort-json | json; input: json | Sort spec JSON object/array |
--sort-file | file; input: file | Path to sort spec JSON file |
--search | string | Free-text lead search |
--limit | integer | Pagination limit |
--cursor | string | Pagination cursor |
--scope | string; choices: org, user | Lead scope |
--source-table-id | string | Research table id used for scope/research context |
--source-table-scope | string; choices: company, lead | Research scope resolution mode |
--related-tables-mode | string; choices: linked, direct, none | How related_tables should be populated |
--include-research-data | boolean; when omitted=false; when present=true | Inline research_data when --source-table-id is provided |
--include-placeholder-leads | boolean; when omitted=false; when present=true | Include placeholder/incomplete lead records |
--ids-only | boolean; when omitted=false; when present=true | Return lead identifiers without workspace enrichment joins |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads count [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--filter-json FILTER_JSON]
[--filter-file FILTER_FILE]
[--sort-json SORT_JSON] [--sort-file SORT_FILE]
[--search SEARCH] [--limit LIMIT]
[--cursor CURSOR] [--scope {org,user}]
[--source-table-id SOURCE_TABLE_ID]
[--source-table-scope {company,lead}]
[--related-tables-mode {linked,direct,none}]
[--include-research-data]
[--include-placeholder-leads] [--ids-only]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads create — Create a lead from a JSON payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Lead create payload JSON |
--data-file | file; input: file | Path to lead create payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads create [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads create-research-table — Add selected leads to a new or existing Research Table
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit bulk lead action payload JSON |
--data-file | file; input: file | Path to bulk lead action payload JSON file |
--lead-id | string; repeatable; comma-separated | Lead id (repeatable; comma-separated also supported) |
--lead-ids-json | json; input: json | JSON array or object with lead_ids[] |
--lead-ids-file | file; input: file | Path to JSON/TXT/CSV file with lead_ids[] |
--lead-ids-column | string; default: "lead_id" | CSV column for lead ids (default: lead_id) |
--filter-json | json; input: json | Filter descriptor JSON object |
--filter-file | file; input: file | Path to filter descriptor JSON file |
--sort-json | json; input: json | Sort spec JSON object/array |
--sort-file | file; input: file | Path to sort spec JSON file |
--search | string | Free-text lead search |
--limit | integer | Optional descriptor selection limit |
--scope | string; choices: org, user | Lead scope |
--source-table-id | string | Optional research table id for descriptor selection |
--source-table-scope | string; choices: company, lead | Optional research scope resolution mode |
--table-name | string | Create a Research Table with this name |
--destination-table-id | string | Add leads to this existing Research Table |
--research-field-id | string; repeatable | Source research field id; repeatable |
--allow-mixed-grain | boolean; when omitted=false; when present=true | Confirm adding Leads-managed rows to an existing generic table |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --table-name, --destination-table-id.
Choose at most one of: --select, --json-pointer.
autotouch leads create-research-table [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--lead-id LEAD_ID]
[--lead-ids-json LEAD_IDS_JSON]
[--lead-ids-file LEAD_IDS_FILE]
[--lead-ids-column LEAD_IDS_COLUMN]
[--filter-json FILTER_JSON]
[--filter-file FILTER_FILE]
[--sort-json SORT_JSON]
[--sort-file SORT_FILE]
[--search SEARCH] [--limit LIMIT]
[--scope {org,user}]
[--source-table-id SOURCE_TABLE_ID]
[--source-table-scope {company,lead}]
[--table-name TABLE_NAME | --destination-table-id DESTINATION_TABLE_ID]
[--research-field-id RESEARCH_FIELD_ID]
[--allow-mixed-grain]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads custom-fields — Set lead custom field values
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: set, bulk-set.
autotouch leads custom-fields [-h] {set,bulk-set} ...autotouch leads custom-fields bulk-set — Set one custom field value on selected leads
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit bulk lead action payload JSON |
--data-file | file; input: file | Path to bulk lead action payload JSON file |
--lead-id | string; repeatable; comma-separated | Lead id (repeatable; comma-separated also supported) |
--lead-ids-json | json; input: json | JSON array or object with lead_ids[] |
--lead-ids-file | file; input: file | Path to JSON/TXT/CSV file with lead_ids[] |
--lead-ids-column | string; default: "lead_id" | CSV column for lead ids (default: lead_id) |
--filter-json | json; input: json | Filter descriptor JSON object |
--filter-file | file; input: file | Path to filter descriptor JSON file |
--sort-json | json; input: json | Sort spec JSON object/array |
--sort-file | file; input: file | Path to sort spec JSON file |
--search | string | Free-text lead search |
--limit | integer | Optional descriptor selection limit |
--scope | string; choices: org, user | Lead scope |
--source-table-id | string | Optional research table id for descriptor selection |
--source-table-scope | string; choices: company, lead | Optional research scope resolution mode |
--field-key | string | Custom field key from `autotouch crm fields list`, not label or id |
--value | string; sensitive | String value to write |
--value-json | json; input: json | Typed JSON value to write |
--value-file | file; input: file | Path to JSON value to write |
--clear | boolean; when omitted=false; when present=true | Clear the custom field value |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --value, --value-json, --value-file, --clear.
Choose at most one of: --select, --json-pointer.
autotouch leads custom-fields bulk-set [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--lead-id LEAD_ID]
[--lead-ids-json LEAD_IDS_JSON]
[--lead-ids-file LEAD_IDS_FILE]
[--lead-ids-column LEAD_IDS_COLUMN]
[--filter-json FILTER_JSON]
[--filter-file FILTER_FILE]
[--sort-json SORT_JSON]
[--sort-file SORT_FILE]
[--search SEARCH]
[--limit LIMIT]
[--scope {org,user}]
[--source-table-id SOURCE_TABLE_ID]
[--source-table-scope {company,lead}]
[--field-key FIELD_KEY]
[--value VALUE | --value-json VALUE_JSON | --value-file VALUE_FILE | --clear]
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads custom-fields set — Set one custom field value on one lead
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--lead-id | string; required | |
--data-json | json; input: json | Explicit custom field payload JSON |
--data-file | file; input: file | Path to custom field payload JSON file |
--field-key | string | Custom field key from `autotouch crm fields list`, not label or id |
--value | string; sensitive | String value to write |
--value-json | json; input: json | Typed JSON value to write |
--value-file | file; input: file | Path to JSON value to write |
--clear | boolean; when omitted=false; when present=true | Clear the custom field value |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --value, --value-json, --value-file, --clear.
Choose at most one of: --select, --json-pointer.
autotouch leads custom-fields set [-h] --lead-id LEAD_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--field-key FIELD_KEY]
[--value VALUE | --value-json VALUE_JSON | --value-file VALUE_FILE | --clear]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads delete — Delete selected Lead workspace records
Auth: developer_key_or_user_session. Stability: stable. Destructive: yes.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit bulk lead action payload JSON |
--data-file | file; input: file | Path to bulk lead action payload JSON file |
--lead-id | string; repeatable; comma-separated | Lead id (repeatable; comma-separated also supported) |
--lead-ids-json | json; input: json | JSON array or object with lead_ids[] |
--lead-ids-file | file; input: file | Path to JSON/TXT/CSV file with lead_ids[] |
--lead-ids-column | string; default: "lead_id" | CSV column for lead ids (default: lead_id) |
--filter-json | json; input: json | Filter descriptor JSON object |
--filter-file | file; input: file | Path to filter descriptor JSON file |
--sort-json | json; input: json | Sort spec JSON object/array |
--sort-file | file; input: file | Path to sort spec JSON file |
--search | string | Free-text lead search |
--limit | integer | Optional descriptor selection limit |
--scope | string; choices: org, user | Lead scope |
--source-table-id | string | Optional research table id for descriptor selection |
--source-table-scope | string; choices: company, lead | Optional research scope resolution mode |
--yes | boolean; when omitted=false; when present=true | Required confirmation for destructive delete |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads delete [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE] [--lead-id LEAD_ID]
[--lead-ids-json LEAD_IDS_JSON]
[--lead-ids-file LEAD_IDS_FILE]
[--lead-ids-column LEAD_IDS_COLUMN]
[--filter-json FILTER_JSON]
[--filter-file FILTER_FILE]
[--sort-json SORT_JSON] [--sort-file SORT_FILE]
[--search SEARCH] [--limit LIMIT]
[--scope {org,user}]
[--source-table-id SOURCE_TABLE_ID]
[--source-table-scope {company,lead}] [--yes]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads exit-sequences — Exit selected leads from active sequences
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit bulk lead action payload JSON |
--data-file | file; input: file | Path to bulk lead action payload JSON file |
--lead-id | string; repeatable; comma-separated | Lead id (repeatable; comma-separated also supported) |
--lead-ids-json | json; input: json | JSON array or object with lead_ids[] |
--lead-ids-file | file; input: file | Path to JSON/TXT/CSV file with lead_ids[] |
--lead-ids-column | string; default: "lead_id" | CSV column for lead ids (default: lead_id) |
--filter-json | json; input: json | Filter descriptor JSON object |
--filter-file | file; input: file | Path to filter descriptor JSON file |
--sort-json | json; input: json | Sort spec JSON object/array |
--sort-file | file; input: file | Path to sort spec JSON file |
--search | string | Free-text lead search |
--limit | integer | Optional descriptor selection limit |
--scope | string; choices: org, user | Lead scope |
--source-table-id | string | Optional research table id for descriptor selection |
--source-table-scope | string; choices: company, lead | Optional research scope resolution mode |
--sequence-id | string; repeatable | Sequence id to limit exits; repeatable |
--sequence-ids-json | json; input: json | JSON array or object with sequenceIds[] |
--sequence-ids-file | file; input: file | Path to JSON/TXT file with sequence ids |
--lead-status | string | Lead status to set after exit |
--unqualified-reason | string | Optional unqualified reason |
--process-limit | integer | Maximum selected leads to process |
--dry-run | boolean; when omitted=true; when present=true | Preview matched exits only |
--execute | boolean; when omitted=true; when present=false | Apply sequence exits |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --dry-run, --execute.
Choose at most one of: --select, --json-pointer.
autotouch leads exit-sequences [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--lead-id LEAD_ID]
[--lead-ids-json LEAD_IDS_JSON]
[--lead-ids-file LEAD_IDS_FILE]
[--lead-ids-column LEAD_IDS_COLUMN]
[--filter-json FILTER_JSON]
[--filter-file FILTER_FILE]
[--sort-json SORT_JSON]
[--sort-file SORT_FILE]
[--search SEARCH] [--limit LIMIT]
[--scope {org,user}]
[--source-table-id SOURCE_TABLE_ID]
[--source-table-scope {company,lead}]
[--sequence-id SEQUENCE_ID]
[--sequence-ids-json SEQUENCE_IDS_JSON]
[--sequence-ids-file SEQUENCE_IDS_FILE]
[--lead-status LEAD_STATUS]
[--unqualified-reason UNQUALIFIED_REASON]
[--process-limit PROCESS_LIMIT]
[--dry-run | --execute]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads filters-metadata — List filterable lead fields and research columns
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads filters-metadata [-h] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads find-emails — Find missing work emails for selected leads
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit bulk lead action payload JSON |
--data-file | file; input: file | Path to bulk lead action payload JSON file |
--lead-id | string; repeatable; comma-separated | Lead id (repeatable; comma-separated also supported) |
--lead-ids-json | json; input: json | JSON array or object with lead_ids[] |
--lead-ids-file | file; input: file | Path to JSON/TXT/CSV file with lead_ids[] |
--lead-ids-column | string; default: "lead_id" | CSV column for lead ids (default: lead_id) |
--filter-json | json; input: json | Filter descriptor JSON object |
--filter-file | file; input: file | Path to filter descriptor JSON file |
--sort-json | json; input: json | Sort spec JSON object/array |
--sort-file | file; input: file | Path to sort spec JSON file |
--search | string | Free-text lead search |
--limit | integer | Optional descriptor selection limit |
--scope | string; choices: org, user | Lead scope |
--source-table-id | string | Optional research table id for descriptor selection |
--source-table-scope | string; choices: company, lead | Optional research scope resolution mode |
--process-limit | integer | Maximum selected leads to process |
--skip-previously-attempted | boolean; when omitted=null; when present=true | |
--retry-previously-attempted | boolean; when omitted=null; when present=false | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --skip-previously-attempted, --retry-previously-attempted.
Choose at most one of: --select, --json-pointer.
autotouch leads find-emails [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE] [--lead-id LEAD_ID]
[--lead-ids-json LEAD_IDS_JSON]
[--lead-ids-file LEAD_IDS_FILE]
[--lead-ids-column LEAD_IDS_COLUMN]
[--filter-json FILTER_JSON]
[--filter-file FILTER_FILE]
[--sort-json SORT_JSON]
[--sort-file SORT_FILE] [--search SEARCH]
[--limit LIMIT] [--scope {org,user}]
[--source-table-id SOURCE_TABLE_ID]
[--source-table-scope {company,lead}]
[--process-limit PROCESS_LIMIT]
[--skip-previously-attempted | --retry-previously-attempted]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads find-mobile-numbers — Find missing mobile numbers for selected leads
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit bulk lead action payload JSON |
--data-file | file; input: file | Path to bulk lead action payload JSON file |
--lead-id | string; repeatable; comma-separated | Lead id (repeatable; comma-separated also supported) |
--lead-ids-json | json; input: json | JSON array or object with lead_ids[] |
--lead-ids-file | file; input: file | Path to JSON/TXT/CSV file with lead_ids[] |
--lead-ids-column | string; default: "lead_id" | CSV column for lead ids (default: lead_id) |
--filter-json | json; input: json | Filter descriptor JSON object |
--filter-file | file; input: file | Path to filter descriptor JSON file |
--sort-json | json; input: json | Sort spec JSON object/array |
--sort-file | file; input: file | Path to sort spec JSON file |
--search | string | Free-text lead search |
--limit | integer | Optional descriptor selection limit |
--scope | string; choices: org, user | Lead scope |
--source-table-id | string | Optional research table id for descriptor selection |
--source-table-scope | string; choices: company, lead | Optional research scope resolution mode |
--process-limit | integer | Maximum selected leads to process |
--skip-previously-attempted | boolean; when omitted=null; when present=true | |
--retry-previously-attempted | boolean; when omitted=null; when present=false | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --skip-previously-attempted, --retry-previously-attempted.
Choose at most one of: --select, --json-pointer.
autotouch leads find-mobile-numbers [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--lead-id LEAD_ID]
[--lead-ids-json LEAD_IDS_JSON]
[--lead-ids-file LEAD_IDS_FILE]
[--lead-ids-column LEAD_IDS_COLUMN]
[--filter-json FILTER_JSON]
[--filter-file FILTER_FILE]
[--sort-json SORT_JSON]
[--sort-file SORT_FILE]
[--search SEARCH] [--limit LIMIT]
[--scope {org,user}]
[--source-table-id SOURCE_TABLE_ID]
[--source-table-scope {company,lead}]
[--process-limit PROCESS_LIMIT]
[--skip-previously-attempted | --retry-previously-attempted]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads get — Get one lead by id
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--lead-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads get [-h] --lead-id LEAD_ID [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads import-csv — Import a CSV into the Leads workspace
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--file | file; required; input: file | Path to the source CSV |
--mappings-json | json; input: json | Confirmed import mappings JSON |
--mappings-file | file; input: file | Path to confirmed import mappings JSON |
--default-values-json | json; input: json | Default standard-field values JSON object |
--default-values-file | file; input: file | Path to default standard-field values JSON |
--custom-field-static-values-json | json; input: json | Fixed lead custom-field values JSON object |
--custom-field-static-values-file | file; input: file | |
--skip-company-blacklist | boolean; when omitted=false; when present=true | |
--skip-email-blacklist | boolean; when omitted=false; when present=true | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads import-csv [-h] --file FILE
[--mappings-json MAPPINGS_JSON]
[--mappings-file MAPPINGS_FILE]
[--default-values-json DEFAULT_VALUES_JSON]
[--default-values-file DEFAULT_VALUES_FILE]
[--custom-field-static-values-json CUSTOM_FIELD_STATIC_VALUES_JSON]
[--custom-field-static-values-file CUSTOM_FIELD_STATIC_VALUES_FILE]
[--skip-company-blacklist]
[--skip-email-blacklist]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads import-preview — Preview CSV headers, samples, and suggested lead mappings without importing
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--file | file; required; input: file | Path to the source CSV |
--sample-size | integer; default: 5 | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads import-preview [-h] --file FILE
[--sample-size SAMPLE_SIZE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads import-status — Get lead CSV import status
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads import-status [-h] --task-id TASK_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads query — Query/filter leads with descriptor payloads
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit leads query payload JSON |
--data-file | file; input: file | Path to leads query payload JSON file |
--filter-json | json; input: json | Filter descriptor JSON object |
--filter-file | file; input: file | Path to filter descriptor JSON file |
--sort-json | json; input: json | Sort spec JSON object/array |
--sort-file | file; input: file | Path to sort spec JSON file |
--search | string | Free-text lead search |
--limit | integer | Pagination limit |
--cursor | string | Pagination cursor |
--scope | string; choices: org, user | Lead scope |
--source-table-id | string | Research table id used for scope/research context |
--source-table-scope | string; choices: company, lead | Research scope resolution mode |
--related-tables-mode | string; choices: linked, direct, none | How related_tables should be populated |
--include-research-data | boolean; when omitted=false; when present=true | Inline research_data when --source-table-id is provided |
--include-placeholder-leads | boolean; when omitted=false; when present=true | Include placeholder/incomplete lead records |
--ids-only | boolean; when omitted=false; when present=true | Return lead identifiers without workspace enrichment joins |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads query [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--filter-json FILTER_JSON]
[--filter-file FILTER_FILE]
[--sort-json SORT_JSON] [--sort-file SORT_FILE]
[--search SEARCH] [--limit LIMIT]
[--cursor CURSOR] [--scope {org,user}]
[--source-table-id SOURCE_TABLE_ID]
[--source-table-scope {company,lead}]
[--related-tables-mode {linked,direct,none}]
[--include-research-data]
[--include-placeholder-leads] [--ids-only]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads reassign-owner — Bulk reassign lead owner by ids or descriptor selection
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit bulk lead action payload JSON |
--data-file | file; input: file | Path to bulk lead action payload JSON file |
--lead-id | string; repeatable; comma-separated | Lead id (repeatable; comma-separated also supported) |
--lead-ids-json | json; input: json | JSON array or object with lead_ids[] |
--lead-ids-file | file; input: file | Path to JSON/TXT/CSV file with lead_ids[] |
--lead-ids-column | string; default: "lead_id" | CSV column for lead ids (default: lead_id) |
--filter-json | json; input: json | Filter descriptor JSON object |
--filter-file | file; input: file | Path to filter descriptor JSON file |
--sort-json | json; input: json | Sort spec JSON object/array |
--sort-file | file; input: file | Path to sort spec JSON file |
--search | string | Free-text lead search |
--limit | integer | Optional descriptor selection limit |
--scope | string; choices: org, user | Lead scope |
--source-table-id | string | Optional research table id for descriptor selection |
--source-table-scope | string; choices: company, lead | Optional research scope resolution mode |
--user-id | string | Target owner user id |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads reassign-owner [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--lead-id LEAD_ID]
[--lead-ids-json LEAD_IDS_JSON]
[--lead-ids-file LEAD_IDS_FILE]
[--lead-ids-column LEAD_IDS_COLUMN]
[--filter-json FILTER_JSON]
[--filter-file FILTER_FILE]
[--sort-json SORT_JSON]
[--sort-file SORT_FILE]
[--search SEARCH] [--limit LIMIT]
[--scope {org,user}]
[--source-table-id SOURCE_TABLE_ID]
[--source-table-scope {company,lead}]
[--user-id USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads recipe — Print lead payload recipes for create/update/query/research/bulk selection
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, create, update, contact_upsert, query, research, selection; default: "all" | |
--out-file | file; input: file | Optional path to save the selected payload JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads recipe [-h]
[--type {all,create,update,contact_upsert,query,research,selection}]
[--out-file OUT_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads research — Fetch research row data for specific lead ids
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit leads research payload JSON |
--data-file | file; input: file | Path to leads research payload JSON file |
--lead-id | string; repeatable; comma-separated | Lead id (repeatable; comma-separated also supported) |
--lead-ids-json | json; input: json | JSON array or object with lead_ids[] |
--lead-ids-file | file; input: file | Path to JSON file with lead_ids[] |
--source-table-id | string | Research table id |
--field-id | string; repeatable; comma-separated | Research field/column id to include (repeatable; comma-separated also supported) |
--field-ids-json | json; input: json | JSON array or object with field_ids[] |
--field-ids-file | file; input: file | Path to JSON file with field_ids[] |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads research [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE] [--lead-id LEAD_ID]
[--lead-ids-json LEAD_IDS_JSON]
[--lead-ids-file LEAD_IDS_FILE]
[--source-table-id SOURCE_TABLE_ID]
[--field-id FIELD_ID]
[--field-ids-json FIELD_IDS_JSON]
[--field-ids-file FIELD_IDS_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads research-tables — List research tables available for lead lookups
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads research-tables [-h] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads stats — Aggregate stats for leads matching a query payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit leads query payload JSON |
--data-file | file; input: file | Path to leads query payload JSON file |
--filter-json | json; input: json | Filter descriptor JSON object |
--filter-file | file; input: file | Path to filter descriptor JSON file |
--sort-json | json; input: json | Sort spec JSON object/array |
--sort-file | file; input: file | Path to sort spec JSON file |
--search | string | Free-text lead search |
--limit | integer | Pagination limit |
--cursor | string | Pagination cursor |
--scope | string; choices: org, user | Lead scope |
--source-table-id | string | Research table id used for scope/research context |
--source-table-scope | string; choices: company, lead | Research scope resolution mode |
--related-tables-mode | string; choices: linked, direct, none | How related_tables should be populated |
--include-research-data | boolean; when omitted=false; when present=true | Inline research_data when --source-table-id is provided |
--include-placeholder-leads | boolean; when omitted=false; when present=true | Include placeholder/incomplete lead records |
--ids-only | boolean; when omitted=false; when present=true | Return lead identifiers without workspace enrichment joins |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads stats [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--filter-json FILTER_JSON]
[--filter-file FILTER_FILE]
[--sort-json SORT_JSON] [--sort-file SORT_FILE]
[--search SEARCH] [--limit LIMIT]
[--cursor CURSOR] [--scope {org,user}]
[--source-table-id SOURCE_TABLE_ID]
[--source-table-scope {company,lead}]
[--related-tables-mode {linked,direct,none}]
[--include-research-data]
[--include-placeholder-leads] [--ids-only]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads update — Update one lead with a partial JSON payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--lead-id | string; required | |
--data-json | json; input: json | Lead update payload JSON |
--data-file | file; input: file | Path to lead update payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads update [-h] --lead-id LEAD_ID [--data-json DATA_JSON]
[--data-file DATA_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads update-status — Bulk update lead status by ids or descriptor selection
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit bulk lead action payload JSON |
--data-file | file; input: file | Path to bulk lead action payload JSON file |
--lead-id | string; repeatable; comma-separated | Lead id (repeatable; comma-separated also supported) |
--lead-ids-json | json; input: json | JSON array or object with lead_ids[] |
--lead-ids-file | file; input: file | Path to JSON/TXT/CSV file with lead_ids[] |
--lead-ids-column | string; default: "lead_id" | CSV column for lead ids (default: lead_id) |
--filter-json | json; input: json | Filter descriptor JSON object |
--filter-file | file; input: file | Path to filter descriptor JSON file |
--sort-json | json; input: json | Sort spec JSON object/array |
--sort-file | file; input: file | Path to sort spec JSON file |
--search | string | Free-text lead search |
--limit | integer | Optional descriptor selection limit |
--scope | string; choices: org, user | Lead scope |
--source-table-id | string | Optional research table id for descriptor selection |
--source-table-scope | string; choices: company, lead | Optional research scope resolution mode |
--status | string | Lead status to apply |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads update-status [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--lead-id LEAD_ID]
[--lead-ids-json LEAD_IDS_JSON]
[--lead-ids-file LEAD_IDS_FILE]
[--lead-ids-column LEAD_IDS_COLUMN]
[--filter-json FILTER_JSON]
[--filter-file FILTER_FILE]
[--sort-json SORT_JSON]
[--sort-file SORT_FILE] [--search SEARCH]
[--limit LIMIT] [--scope {org,user}]
[--source-table-id SOURCE_TABLE_ID]
[--source-table-scope {company,lead}]
[--status STATUS] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads upsert-contact-channels — Merge emails/phones into a lead without replacing the full arrays
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Aliases: upsert-contacts.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--lead-id | string; required | |
--data-json | json; input: json | Contact upsert payload JSON |
--data-file | file; input: file | Path to contact upsert payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch leads upsert-contact-channels [-h] --lead-id LEAD_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch leads validate-emails — Validate existing emails for selected leads
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit bulk lead action payload JSON |
--data-file | file; input: file | Path to bulk lead action payload JSON file |
--lead-id | string; repeatable; comma-separated | Lead id (repeatable; comma-separated also supported) |
--lead-ids-json | json; input: json | JSON array or object with lead_ids[] |
--lead-ids-file | file; input: file | Path to JSON/TXT/CSV file with lead_ids[] |
--lead-ids-column | string; default: "lead_id" | CSV column for lead ids (default: lead_id) |
--filter-json | json; input: json | Filter descriptor JSON object |
--filter-file | file; input: file | Path to filter descriptor JSON file |
--sort-json | json; input: json | Sort spec JSON object/array |
--sort-file | file; input: file | Path to sort spec JSON file |
--search | string | Free-text lead search |
--limit | integer | Optional descriptor selection limit |
--scope | string; choices: org, user | Lead scope |
--source-table-id | string | Optional research table id for descriptor selection |
--source-table-scope | string; choices: company, lead | Optional research scope resolution mode |
--process-limit | integer | Maximum selected leads to process |
--skip-previously-attempted | boolean; when omitted=null; when present=true | |
--retry-previously-attempted | boolean; when omitted=null; when present=false | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --skip-previously-attempted, --retry-previously-attempted.
Choose at most one of: --select, --json-pointer.
autotouch leads validate-emails [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--lead-id LEAD_ID]
[--lead-ids-json LEAD_IDS_JSON]
[--lead-ids-file LEAD_IDS_FILE]
[--lead-ids-column LEAD_IDS_COLUMN]
[--filter-json FILTER_JSON]
[--filter-file FILTER_FILE]
[--sort-json SORT_JSON]
[--sort-file SORT_FILE]
[--search SEARCH] [--limit LIMIT]
[--scope {org,user}]
[--source-table-id SOURCE_TABLE_ID]
[--source-table-scope {company,lead}]
[--process-limit PROCESS_LIMIT]
[--skip-previously-attempted | --retry-previously-attempted]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch linkedin — Connected LinkedIn account operations
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: status, limits.
autotouch linkedin [-h] {status,limits} ...autotouch linkedin limits — View LinkedIn send limits and usage
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch linkedin limits [-h] [--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch linkedin status — Check LinkedIn connection status
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch linkedin status [-h] [--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]list-build
autotouch list-build — Build durable sourced company, lead, job, and local-business lists
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: companies, leads, jobs, local-businesses, status, results, sync-to-table, inputs, pricing.
autotouch list-build [-h]
{companies,leads,jobs,local-businesses,status,results,sync-to-table,inputs,pricing}
...autotouch list-build companies — Build a company list from native company search
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Build a durable company list using structured native filters. Use --filters-json or --data-file for the complete contract.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit list-build payload JSON |
--data-file | file; input: file | Path to list-build payload JSON file |
--list-name | string | Optional display name |
--num-results | integer; default: 100 | Result count, 1–1500; additional results when resuming |
--page-size | integer; default: 25 | Search page size, 1–25 |
--wait | boolean; when omitted=false; when present=true | Poll until terminal status |
--poll-interval | integer; default: 5 | Polling interval seconds for --wait |
--wait-timeout | integer; default: 0 | Max seconds to wait (0 = no timeout) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
--filters-json | json; input: json | Full source filter object; use operation detail for all supported fields |
--country-code | string; repeatable | ISO country code; company HQ for companies, person location for leads |
--state | string; repeatable | State name; company HQ for companies, person location for leads |
--city | string; repeatable | City; company HQ for companies, person location for leads |
--from-job-id | string | Resume a completed delivered list using its saved cursor and unchanged scope |
--table-name | string | Create and deliver to a new Research Table |
--table-id | string | Append a fresh search to an existing table; use --from-job-id for more of the same |
Choose at most one of: --select, --json-pointer.
Choose at most one of: --table-name, --table-id.
Example:
autotouch list-build companies --primary-industry software --country-code US --company-size 51-200 --num-results 500
Run `autotouch list-build inputs` to inspect canonical industry and size values.autotouch list-build companies [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--list-name LIST_NAME]
[--num-results NUM_RESULTS]
[--page-size PAGE_SIZE] [--wait]
[--poll-interval POLL_INTERVAL]
[--wait-timeout WAIT_TIMEOUT]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
[--filters-json FILTERS_JSON]
[--country-code COUNTRY_CODE]
[--state STATE] [--city CITY]
[--from-job-id FROM_JOB_ID]
[--table-name TABLE_NAME | --table-id TABLE_ID]autotouch list-build inputs — Show valid list-build filter IDs and values
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string | Operation-specific lookup dimension from the input catalog |
--operation-id | string | Exact operation, e.g. lists.build_people, for native value lookup |
--query | string | Search text for input ID lookup |
--limit | integer; default: 20 | Max lookup results, 1-50 |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch list-build inputs [-h] [--type TYPE]
[--operation-id OPERATION_ID]
[--query QUERY] [--limit LIMIT]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch list-build jobs — Build a job posting list
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit list-build payload JSON |
--data-file | file; input: file | Path to list-build payload JSON file |
--list-name | string | Optional display name |
--num-results | integer; default: 100 | Target result count; maximum depends on source |
--page-size | integer; default: 25 | Source result page size, max 50 |
--wait | boolean; when omitted=false; when present=true | Poll until terminal status |
--poll-interval | integer; default: 5 | Polling interval seconds for --wait |
--wait-timeout | integer; default: 0 | Max seconds to wait (0 = no timeout) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
--query | string | Job search query; used as the title target when --job-title is omitted |
--job-title | string; repeatable | Job title to find; repeat for multiple titles |
--keywords | string | Optional job description/company keyword filter |
--location | string; repeatable | Hiring location, e.g. United States or New York |
--company-location | string; repeatable | Company HQ/base location, e.g. New York or United States |
--company | string; repeatable | Company/employer name to include; repeat for multiple |
--exclude-company | string; repeatable | Company/employer name to exclude; repeat for multiple |
--industry | string; repeatable | Optional industry label for jobs provider filtering |
--company-size | string; repeatable | Company size bucket, e.g. 1-10 or 11-50 |
--company-domain | string; repeatable | Restrict results to company domains; repeat for multiple |
--lookback | string; choices: 1h, 24h, 7d, 30d; default: "24h" | Posted-within lookback window |
--remote | string; choices: any, remote, onsite, hybrid; default: "any" | Remote preference |
Choose at most one of: --select, --json-pointer.
autotouch list-build jobs [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--list-name LIST_NAME]
[--num-results NUM_RESULTS]
[--page-size PAGE_SIZE] [--wait]
[--poll-interval POLL_INTERVAL]
[--wait-timeout WAIT_TIMEOUT]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose] [--query QUERY]
[--job-title JOB_TITLE] [--keywords KEYWORDS]
[--location LOCATION]
[--company-location COMPANY_LOCATION]
[--company COMPANY]
[--exclude-company EXCLUDE_COMPANY]
[--industry INDUSTRY]
[--company-size COMPANY_SIZE]
[--company-domain COMPANY_DOMAIN]
[--lookback {1h,24h,7d,30d}]
[--remote {any,remote,onsite,hybrid}]autotouch list-build leads — Build a lead/contact list
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit list-build payload JSON |
--data-file | file; input: file | Path to list-build payload JSON file |
--list-name | string | Optional display name |
--num-results | integer; default: 100 | Result count, 1–1500; additional results when resuming |
--page-size | integer; default: 25 | Search page size, 1–25 |
--wait | boolean; when omitted=false; when present=true | Poll until terminal status |
--poll-interval | integer; default: 5 | Polling interval seconds for --wait |
--wait-timeout | integer; default: 0 | Max seconds to wait (0 = no timeout) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
--filters-json | json; input: json | Full source filter object; use operation detail for all supported fields |
--country-code | string; repeatable | ISO country code; company HQ for companies, person location for leads |
--state | string; repeatable | State name; company HQ for companies, person location for leads |
--city | string; repeatable | City; company HQ for companies, person location for leads |
--from-job-id | string | Resume a completed delivered list using its saved cursor and unchanged scope |
--table-name | string | Create and deliver to a new Research Table |
--table-id | string | Append a fresh search to an existing table; use --from-job-id for more of the same |
--title | string; repeatable | Person title phrase; repeat for OR alternatives preserving the requested role |
Choose at most one of: --select, --json-pointer.
Choose at most one of: --table-name, --table-id.
autotouch list-build leads [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--list-name LIST_NAME]
[--num-results NUM_RESULTS]
[--page-size PAGE_SIZE] [--wait]
[--poll-interval POLL_INTERVAL]
[--wait-timeout WAIT_TIMEOUT]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose] [--filters-json FILTERS_JSON]
[--country-code COUNTRY_CODE]
[--state STATE] [--city CITY]
[--from-job-id FROM_JOB_ID]
[--table-name TABLE_NAME | --table-id TABLE_ID]
[--title TITLE]autotouch list-build local-businesses — Build a local-business list from Maps postal cells
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Build a durable local-business list. The backend resolves real ZIP cells from city/state and rejects invented postal codes.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Explicit list-build payload JSON |
--data-file | file; input: file | Path to list-build payload JSON file |
--list-name | string | Optional display name |
--num-results | integer; default: 100 | Businesses to return with --completion-mode bounded, 1-1500 |
--page-size | integer; default: 25 | Unused for local-business cell sweeps |
--wait | boolean; when omitted=false; when present=true | Poll until terminal status |
--poll-interval | integer; default: 5 | Polling interval seconds for --wait |
--wait-timeout | integer; default: 0 | Max seconds to wait (0 = no timeout) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
--query | string; required | Business-activity query, e.g. 'ice cream shops' |
--city | string | US city whose ZIPs the host resolves, e.g. Athens |
--state | string | US state for the city, e.g. TN |
--country | string; default: "us" | ISO alpha-2 country code (default us) |
--language | string; default: "en" | Provider language code (default en) |
--zip | string; repeatable | Explicit US ZIP cell; repeat for multiple |
--area | string; repeatable | Explicit cell as TYPE:VALUE, e.g. postal_district:LS1; repeat for multiple |
--completion-mode | string; choices: bounded, all_available; default: "all_available" | bounded needs --num-results; all_available sweeps resolved cells |
Choose at most one of: --select, --json-pointer.
autotouch list-build local-businesses [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--list-name LIST_NAME]
[--num-results NUM_RESULTS]
[--page-size PAGE_SIZE] [--wait]
[--poll-interval POLL_INTERVAL]
[--wait-timeout WAIT_TIMEOUT]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose] --query QUERY
[--city CITY] [--state STATE]
[--country COUNTRY]
[--language LANGUAGE] [--zip ZIP]
[--area AREA]
[--completion-mode {bounded,all_available}]autotouch list-build pricing — Show list-build pricing rules
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch list-build pricing [-h] [--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch list-build results — Get list-build results
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--job-id | string; required | |
--type | string; choices: items, companies, leads, jobs, businesses, all; default: "items" | |
--page | integer; default: 1 | |
--page-size | integer; default: 50 | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch list-build results [-h] --job-id JOB_ID
[--type {items,companies,leads,jobs,businesses,all}]
[--page PAGE] [--page-size PAGE_SIZE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch list-build status — Get list-build job status
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--job-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch list-build status [-h] --job-id JOB_ID [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch list-build sync-to-table — Sync list-build results into a Smart Table
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--job-id | string; required | |
--type | string; choices: items, companies, leads, jobs, businesses, all | Result type to sync; defaults to the job kind |
--table-id | string | Existing Smart Table id for append/upsert |
--table-name | string | New Smart Table name when creating a table |
--table-mode | string; choices: create, append | Create a new table or append/upsert into --table-id |
--identity-key | string; default: "auto" | Dedupe identity key: auto, global_company_id, linkedin_url, linkedin_company_id, linkedin_company_url, or domain |
--dedupe-mode | string; choices: allow, skip, upsert; default: "upsert" | How to handle matching rows |
--merge-mode | string; choices: fill_empty, overwrite_mapped; default: "fill_empty" | How upserts merge values |
--allow-partial | boolean; when omitted=false; when present=true | Allow syncing before the list-build job is completed |
--wait | boolean; when omitted=false; when present=true | Poll until sync completes |
--poll-interval | integer; default: 5 | Polling interval seconds for --wait |
--wait-timeout | integer; default: 0 | Max seconds to wait (0 = no timeout) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch list-build sync-to-table [-h] --job-id JOB_ID
[--type {items,companies,leads,jobs,businesses,all}]
[--table-id TABLE_ID]
[--table-name TABLE_NAME]
[--table-mode {create,append}]
[--identity-key IDENTITY_KEY]
[--dedupe-mode {allow,skip,upsert}]
[--merge-mode {fill_empty,overwrite_mapped}]
[--allow-partial] [--wait]
[--poll-interval POLL_INTERVAL]
[--wait-timeout WAIT_TIMEOUT]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]notes
autotouch notes — Rich notes, dated research journals, and revision history
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: journals, create, list, get, update, delete, revisions.
autotouch notes [-h]
{journals,create,list,get,update,delete,revisions} ...autotouch notes create — create notes resource
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Complete write payload JSON |
--data-file | file; input: file | Complete write payload JSON file |
--title | string | |
--idempotency-key | string | Stable key for retries; 8-200 characters |
--content-file | file; input: file | UTF-8 Markdown file; rich blocks may be supplied through JSON |
--kind | string; choices: general, meeting, research_update | |
--journal-id | string | |
--observed-at | string | ISO 8601 observation timestamp |
--pinned, --no-pinned | string | |
--entity-type | string; choices: lead, company, deal | |
--entity-id | string | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch notes create [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE] [--title TITLE]
[--idempotency-key IDEMPOTENCY_KEY]
[--content-file CONTENT_FILE]
[--kind {general,meeting,research_update}]
[--journal-id JOURNAL_ID]
[--observed-at OBSERVED_AT]
[--pinned | --no-pinned]
[--entity-type {lead,company,deal}]
[--entity-id ENTITY_ID] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch notes delete — delete notes resource
Auth: developer_key_or_user_session. Stability: stable. Destructive: yes.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--note-id | string; required | |
--data-json | json; input: json | Complete write payload JSON |
--data-file | file; input: file | Complete write payload JSON file |
--idempotency-key | string | Stable key for retries; 8-200 characters |
--expected-version | integer | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch notes delete [-h] --note-id NOTE_ID [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--idempotency-key IDEMPOTENCY_KEY]
[--expected-version EXPECTED_VERSION]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch notes get — get notes resource
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--note-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch notes get [-h] --note-id NOTE_ID [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch notes journals — Group dated research entries
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: create, list, get.
autotouch notes journals [-h] {create,list,get} ...autotouch notes journals create — journals create notes resource
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Complete write payload JSON |
--data-file | file; input: file | Complete write payload JSON file |
--title | string | |
--idempotency-key | string | Stable key for retries; 8-200 characters |
--entity-type | string; choices: lead, company, deal | |
--entity-id | string | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch notes journals create [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE] [--title TITLE]
[--idempotency-key IDEMPOTENCY_KEY]
[--entity-type {lead,company,deal}]
[--entity-id ENTITY_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch notes journals get — journals get notes resource
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--journal-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch notes journals get [-h] --journal-id JOURNAL_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch notes journals list — journals list notes resource
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--entity-type | string; choices: lead, company, deal | |
--entity-id | string | |
--limit | integer | |
--cursor | string | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch notes journals list [-h] [--entity-type {lead,company,deal}]
[--entity-id ENTITY_ID] [--limit LIMIT]
[--cursor CURSOR] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch notes list — list notes resource
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--entity-type | string; choices: lead, company, deal | |
--entity-id | string | |
--limit | integer | |
--cursor | string | |
--journal-id | string | |
--kind | string; choices: general, meeting, research_update | |
--search | string | |
--author-id | string | |
--archived, --no-archived | string | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch notes list [-h] [--entity-type {lead,company,deal}]
[--entity-id ENTITY_ID] [--limit LIMIT]
[--cursor CURSOR] [--journal-id JOURNAL_ID]
[--kind {general,meeting,research_update}]
[--search SEARCH] [--author-id AUTHOR_ID]
[--archived | --no-archived] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch notes revisions — revisions notes resource
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--note-id | string; required | |
--limit | integer | |
--cursor | string | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch notes revisions [-h] --note-id NOTE_ID [--limit LIMIT]
[--cursor CURSOR] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch notes update — update notes resource
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--note-id | string; required | |
--data-json | json; input: json | Complete write payload JSON |
--data-file | file; input: file | Complete write payload JSON file |
--title | string | |
--idempotency-key | string | Stable key for retries; 8-200 characters |
--content-file | file; input: file | UTF-8 Markdown file; rich blocks may be supplied through JSON |
--kind | string; choices: general, meeting, research_update | |
--journal-id | string | |
--observed-at | string | ISO 8601 observation timestamp |
--pinned, --no-pinned | string | |
--expected-version | integer | |
--archived, --no-archived | string | |
--entity-type | string; choices: lead, company, deal | |
--entity-id | string | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch notes update [-h] --note-id NOTE_ID [--data-json DATA_JSON]
[--data-file DATA_FILE] [--title TITLE]
[--idempotency-key IDEMPOTENCY_KEY]
[--content-file CONTENT_FILE]
[--kind {general,meeting,research_update}]
[--journal-id JOURNAL_ID]
[--observed-at OBSERVED_AT]
[--pinned | --no-pinned]
[--expected-version EXPECTED_VERSION]
[--archived | --no-archived]
[--entity-type {lead,company,deal}]
[--entity-id ENTITY_ID] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]onboarding
autotouch onboarding — Onboarding helpers
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: submit-domain, schema.
autotouch onboarding [-h] {submit-domain,schema} ...autotouch onboarding schema — Print onboarding payload schemas
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, submit_domain; default: "all" | |
--out-file | file; input: file | Write schema JSON to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch onboarding schema [-h] [--type {all,submit_domain}]
[--out-file OUT_FILE]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch onboarding submit-domain — Analyze company website and seed org context
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--website | string | Company website/domain |
--domain | string | Alias for --website |
--data-json | json; input: json | Explicit submit-domain payload JSON |
--data-file | file; input: file | Path to submit-domain payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch onboarding submit-domain [-h] [--website WEBSITE]
[--domain DOMAIN]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]org-context
autotouch org-context — Organization value prop / ICP context
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: get, set, schema.
autotouch org-context [-h] {get,set,schema} ...autotouch org-context get — Fetch organization context
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch org-context get [-h] [--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch org-context schema — Print org-context payload schemas
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, set; default: "all" | |
--out-file | file; input: file | Write schema JSON to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch org-context schema [-h] [--type {all,set}]
[--out-file OUT_FILE]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch org-context set — Save organization context
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--source | string; default: "cli" | Context source label (default: cli) |
--value-proposition | string | Organization value proposition |
--ideal-title | string; repeatable; comma-separated | Ideal title (repeatable; comma-separated also supported) |
--buyer-persona | string | Buyer persona / ICP buyer |
--user-persona | string | User persona / ICP users |
--voice-profile | string | Voice profile guidance |
--case-study-url | string; repeatable | Case-study URL (repeatable) |
--data-json | json; input: json | Explicit org context payload JSON |
--data-file | file; input: file | Path to org context payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch org-context set [-h] [--source SOURCE]
[--value-proposition VALUE_PROPOSITION]
[--ideal-title IDEAL_TITLE]
[--buyer-persona BUYER_PERSONA]
[--user-persona USER_PERSONA]
[--voice-profile VOICE_PROFILE]
[--case-study-url CASE_STUDY_URL]
[--data-json DATA_JSON]
[--data-file DATA_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]organization
autotouch organization — Current organization discovery
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: users.
autotouch organization [-h] {users} ...autotouch organization users — List current organization users with optional search and pagination (users:read)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
List current organization users with optional search and pagination (users:read)
| Argument | Contract | Description |
|---|---|---|
--query | string | |
--limit | integer | Maximum users to return, 1-1000; omit for all remaining users |
--offset | integer | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch organization users [-h] [--query QUERY] [--limit LIMIT]
[--offset OFFSET] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]outreach
autotouch outreach — Manage Instantly/Smartlead campaign handoff from Autotouch
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: accounts, campaigns.
Manage external outreach-provider campaigns used by research-table to_outreach. Autotouch can create/configure campaigns, map healthy sender accounts, upload rows, and explicitly activate/pause campaigns; the provider runs the campaign after activation.
autotouch outreach accounts list --provider instantly
autotouch outreach campaigns list --provider instantly
autotouch outreach campaigns create --provider instantly --name 'June Buyers' --min-health-score 100
autotouch columns recipe --type to_outreach --out-file push-to-outreach.jsonautotouch outreach accounts — Inspect eligible provider sending accounts
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list.
autotouch outreach accounts [-h] {list} ...autotouch outreach accounts list — List Instantly/Smartlead sending accounts with Autotouch eligibility applied
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--provider | string; choices: instantly, smartlead | Filter provider |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch outreach accounts list [-h]
[--provider {instantly,smartlead}]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch outreach campaigns — List, create, and manage provider campaigns
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, get, create, sync-accounts, sync-templates, activate, pause.
autotouch outreach campaigns [-h]
{list,get,create,sync-accounts,sync-templates,activate,pause}
...autotouch outreach campaigns activate — Activate a provider campaign
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: instantly, smartlead | |
--campaign-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch outreach campaigns activate [-h] --provider
{instantly,smartlead}
--campaign-id CAMPAIGN_ID
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch outreach campaigns create — Create a draft provider campaign
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Create an Instantly/Smartlead campaign and attach eligible sending accounts. The campaign is draft/inactive by default; use activate explicitly when ready. Use --data-file for optional schedule or deterministic template steps.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: instantly, smartlead | |
--name | string | Campaign name; required unless provided in --data-json/--data-file |
--account-selection | string; choices: all_eligible, selected; default: "all_eligible" | Sending account pool selection (default: all_eligible) |
--selected-account | string; repeatable | Sending account email when --account-selection selected; repeatable |
--min-health-score | integer | One-off mailbox health threshold 0-100; does not update org settings |
--activate | boolean; when omitted=false; when present=true | Activate immediately after create |
--data-json | json; input: json | Explicit JSON payload |
--data-file | file; input: file | Path to JSON payload file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch outreach campaigns create [-h] --provider
{instantly,smartlead} [--name NAME]
[--account-selection {all_eligible,selected}]
[--selected-account SELECTED_ACCOUNT]
[--min-health-score MIN_HEALTH_SCORE]
[--activate]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch outreach campaigns get — Get one provider campaign
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: instantly, smartlead | |
--campaign-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch outreach campaigns get [-h] --provider {instantly,smartlead}
--campaign-id CAMPAIGN_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch outreach campaigns list — List provider campaigns
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: instantly, smartlead | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch outreach campaigns list [-h] --provider {instantly,smartlead}
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch outreach campaigns pause — Pause a provider campaign
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: instantly, smartlead | |
--campaign-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch outreach campaigns pause [-h] --provider
{instantly,smartlead} --campaign-id
CAMPAIGN_ID [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch outreach campaigns sync-accounts — Sync campaign sender account pool
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: instantly, smartlead | |
--campaign-id | string; required | |
--account-selection | string; choices: all_eligible, selected; default: "all_eligible" | Sending account pool selection (default: all_eligible) |
--selected-account | string; repeatable | Sending account email when --account-selection selected; repeatable |
--min-health-score | integer | One-off mailbox health threshold 0-100; does not update org settings |
--no-refresh | boolean; when omitted=false; when present=true | Use cached provider account snapshot |
--data-json | json; input: json | Explicit JSON payload |
--data-file | file; input: file | Path to JSON payload file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch outreach campaigns sync-accounts [-h] --provider
{instantly,smartlead}
--campaign-id CAMPAIGN_ID
[--account-selection {all_eligible,selected}]
[--selected-account SELECTED_ACCOUNT]
[--min-health-score MIN_HEALTH_SCORE]
[--no-refresh]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch outreach campaigns sync-templates — Sync deterministic provider template steps
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--provider | string; required; choices: instantly, smartlead | |
--campaign-id | string; required | |
--data-json | json; input: json | Explicit JSON payload |
--data-file | file; input: file | Path to JSON payload file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch outreach campaigns sync-templates [-h] --provider
{instantly,smartlead}
--campaign-id CAMPAIGN_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]personal-context
autotouch personal-context — Personal sender / rep context
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: get, set, schema.
autotouch personal-context [-h] {get,set,schema} ...autotouch personal-context get — Fetch personal context
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch personal-context get [-h] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch personal-context schema — Print personal-context payload schemas
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, set; default: "all" | |
--out-file | file; input: file | Write schema JSON to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch personal-context schema [-h] [--type {all,set}]
[--out-file OUT_FILE]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch personal-context set — Save personal context
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--title | string | User title |
--linkedin-url | string | User LinkedIn URL |
--voice-profile | string | Personal voice profile guidance |
--use-personal-voice-profile | boolean; when omitted=false; when present=true | Prefer the personal voice profile over org default |
--data-json | json; input: json | Explicit personal context payload JSON |
--data-file | file; input: file | Path to personal context payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch personal-context set [-h] [--title TITLE]
[--linkedin-url LINKEDIN_URL]
[--voice-profile VOICE_PROFILE]
[--use-personal-voice-profile]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]prompts
autotouch prompts — Manage saved prompt templates for Quick LLM, Agent, and Classify columns
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, get, create, update, delete, schema.
List, create, update, and delete prompt templates used by Quick LLM, Agent, and Classify columns. Templates can be scoped to a single user (private) or shared with the team.
Developer API keys need prompts:read / prompts:write scopes (or *) for these endpoints.autotouch prompts list
autotouch prompts list --mode agent
autotouch prompts get --id <TEMPLATE_ID>
autotouch prompts create --data-file prompt.json
autotouch prompts delete --id <TEMPLATE_ID> --yesautotouch prompts create — Create a new prompt template
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Create a new prompt template. Requires a JSON payload with name, content, type, and mode.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Inline JSON payload |
--data-file | file; input: file | Path to JSON payload file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch prompts create [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch prompts delete — Delete a prompt template
Auth: developer_key_or_user_session. Stability: stable. Destructive: yes.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--id | string; required | Prompt template ID |
--yes | boolean; when omitted=false; when present=true | Confirm deletion |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch prompts delete [-h] --id ID [--yes] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch prompts get — Get a single prompt template by ID
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--id | string; required | Prompt template ID |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch prompts get [-h] --id ID [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch prompts list — List prompt templates
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--mode | string; choices: basic, agent, classify | Filter by mode |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch prompts list [-h] [--mode {basic,agent,classify}]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch prompts schema — Print prompt template payload schemas
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, create, update; default: "all" | |
--out-file | file; input: file | Write schema JSON to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch prompts schema [-h] [--type {all,create,update}]
[--out-file OUT_FILE]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch prompts update — Update an existing prompt template
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Partially update a prompt template. Only include the fields you want to change.
| Argument | Contract | Description |
|---|---|---|
--id | string; required | Prompt template ID |
--data-json | json; input: json | Inline JSON payload |
--data-file | file; input: file | Path to JSON payload file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch prompts update [-h] --id ID [--data-json DATA_JSON]
[--data-file DATA_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]rows
autotouch rows — Row operations
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, get, add, import-csv, dedupe, blacklist-check, schema, import-status, import-verify, import-rollback, delete.
autotouch rows [-h]
{list,get,add,import-csv,dedupe,blacklist-check,schema,import-status,import-verify,import-rollback,delete}
...autotouch rows add — Add blank/manual rows; record payloads patch manual/direct-writable columns only
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Add blank rows or patch manual/direct-writable columns from a records payload. For semantic/protected/source-managed columns, use rows import-csv --transport optimized so import validation runs before writes.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--count | integer; default: 1 | Blank rows to create (ignored if records provided) |
--records-json | json; input: json | Object, list, or {records:[...]} payload for manual/direct-writable columns only |
--records-file | file; input: file | Path to JSON records payload for manual/direct-writable columns only; use import-csv for semantic/protected columns |
--detect-types | boolean; when omitted=false; when present=true | Enable detect_types when patching record values |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch rows add [-h] --table-id TABLE_ID [--count COUNT]
[--records-json RECORDS_JSON]
[--records-file RECORDS_FILE] [--detect-types]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch rows blacklist-check — Check a domain/website column against the organization company blacklist
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-key | string; required | Company domain, website, or URL column |
--async-job | boolean; when omitted=false; when present=true | Use the durable bulk-job path instead of the direct read |
--wait | boolean; when omitted=false; when present=true | Wait for an async blacklist job to finish |
--poll-interval | number; default: 2 | Polling interval seconds |
--wait-timeout | integer; default: 0 | Maximum wait seconds (0 = no limit) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch rows blacklist-check [-h] --table-id TABLE_ID --column-key
COLUMN_KEY [--async-job] [--wait]
[--poll-interval POLL_INTERVAL]
[--wait-timeout WAIT_TIMEOUT]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch rows dedupe — Preview or remove duplicate rows by column value
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-key | string; required | Column to deduplicate on |
--stats-only, --dry-run | boolean; when omitted=false; when present=true | Print deduplication preview without deleting rows |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch rows dedupe [-h] --table-id TABLE_ID --column-key COLUMN_KEY
[--stats-only] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch rows delete — Delete a single row
Auth: developer_key_or_user_session. Stability: stable. Destructive: yes.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--row-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch rows delete [-h] --table-id TABLE_ID --row-id ROW_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch rows get — Get one flattened row by id
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--row-id | string; required | |
--parse-json-cells | boolean; when omitted=false; when present=true | Parse stringified JSON object/array cell values before printing output |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch rows get [-h] --table-id TABLE_ID --row-id ROW_ID
[--parse-json-cells] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch rows import-csv — Import CSV rows through the optimized import pipeline by default
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human. Supports streaming progress.
Import CSV rows. Optimized transport is recommended for semantic/protected columns, field mapping, domain upsert, durable task status, verification, and rollback.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--confirm-table-id | string | Safety check: must match --table-id or command exits |
--file | file; required; input: file | CSV file path |
--transport | string; choices: optimized, direct; default: "optimized" | Import transport: optimized uses /import-optimized (recommended for semantic/protected columns); direct uses row/cell API loop for manual columns only |
--dry-run | boolean; when omitted=false; when present=true | Parse CSV and print summary without creating rows |
--validate-only | boolean; when omitted=false; when present=true | Server-side CSV parse/shape validation only (no writes) |
--sample-size | integer; default: 5 | Sample rows returned by --validate-only (0-20, default: 5) |
--checkpoint-file | file; input: file | Optional JSON checkpoint file (guards duplicate imports unless --allow-reimport) |
--allow-reimport | boolean; when omitted=false; when present=true | Ignore checkpoint guard and import again |
--expected-rows | integer | Assert row count equals this value |
--require-columns | string; repeatable; comma-separated | Assert required column keys exist (comma-separated; repeatable) |
--duplicate-key | string; repeatable; comma-separated | Assert no duplicates on this identity key (comma-separated; repeatable) |
--require-non-empty | string; repeatable; comma-separated | Assert non-empty ratio by key (key:ratio, comma-separated; repeatable) |
--delimiter | string; default: "," | CSV delimiter (default: ,) |
--encoding | string; default: "utf-8" | File encoding (default: utf-8) |
--limit | integer | Optional max records to import |
--no-trim-headers | boolean; when omitted=true; when present=false | Do not trim header whitespace |
--trim-values | boolean; when omitted=false; when present=true | Trim cell string values |
--no-empty-as-null | boolean; when omitted=true; when present=false | Preserve empty strings instead of null |
--no-skip-empty-rows | boolean; when omitted=true; when present=false | Keep fully empty rows |
--detect-types | boolean; when omitted=false; when present=true | Enable detect_types while patching |
--origin | string; default: "csv" | Column origin tag for optimized import |
--field-mappings-json | json; input: json | Field mappings JSON object for optimized import |
--field-mappings-file | file; input: file | Field mappings JSON file for optimized import |
--no-check-company-blacklist | boolean; when omitted=true; when present=false | Disable company blacklist filtering for optimized import |
--check-email-blacklist | boolean; when omitted=false; when present=true | Enable email blacklist filtering for optimized import |
--sync | boolean; when omitted=false; when present=true | Wait for the queued Runtime v2 import to reach terminal status (client-side alias for --wait) |
--wait | boolean; when omitted=false; when present=true | Wait for the queued Runtime v2 import to reach terminal status |
--poll-interval | integer; default: 2 | Polling interval seconds when waiting |
--wait-timeout | integer; default: 0 | Max seconds to wait with --wait/--sync (0 = no timeout) |
--ingest-mode | string; choices: allow, skip, upsert | Duplicate handling: allow / skip / upsert (enables server-side identity resolution) |
--match-rule-id | string | Use a pre-configured table identity rule by ID |
--match-column | string | Column key to match on (when no rule-id) |
--match-strategy | string; choices: email, domain, linkedin_url, external_id, exact_text | Normalisation strategy for the match column |
--merge-mode | string; choices: fill_empty, overwrite_mapped | Cell merge strategy when upserting (default: fill_empty) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch rows import-csv [-h] --table-id TABLE_ID
[--confirm-table-id CONFIRM_TABLE_ID] --file
FILE [--transport {optimized,direct}]
[--dry-run] [--validate-only]
[--sample-size SAMPLE_SIZE]
[--checkpoint-file CHECKPOINT_FILE]
[--allow-reimport]
[--expected-rows EXPECTED_ROWS]
[--require-columns REQUIRE_COLUMNS]
[--duplicate-key DUPLICATE_KEY]
[--require-non-empty REQUIRE_NON_EMPTY]
[--delimiter DELIMITER] [--encoding ENCODING]
[--limit LIMIT] [--no-trim-headers]
[--trim-values] [--no-empty-as-null]
[--no-skip-empty-rows] [--detect-types]
[--origin ORIGIN]
[--field-mappings-json FIELD_MAPPINGS_JSON]
[--field-mappings-file FIELD_MAPPINGS_FILE]
[--no-check-company-blacklist]
[--check-email-blacklist] [--sync] [--wait]
[--poll-interval POLL_INTERVAL]
[--wait-timeout WAIT_TIMEOUT]
[--ingest-mode {allow,skip,upsert}]
[--match-rule-id MATCH_RULE_ID]
[--match-column MATCH_COLUMN]
[--match-strategy {email,domain,linkedin_url,external_id,exact_text}]
[--merge-mode {fill_empty,overwrite_mapped}]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch rows import-rollback — Rollback rows created by import task_id
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--task-id | string; required | |
--dry-run | boolean; when omitted=false; when present=true | Preview rollback scope without deleting rows |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch rows import-rollback [-h] --table-id TABLE_ID --task-id
TASK_ID [--dry-run]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch rows import-status — Get or watch CSV import task status
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human. Supports streaming progress.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--task-id | string; required | |
--wait | boolean; when omitted=false; when present=true | Poll until the import reaches terminal status |
--poll-interval | integer; default: 2 | Polling interval seconds for --wait |
--wait-timeout | integer; default: 0 | Max seconds to wait (0 = no timeout) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch rows import-status [-h] --table-id TABLE_ID --task-id TASK_ID
[--wait] [--poll-interval POLL_INTERVAL]
[--wait-timeout WAIT_TIMEOUT]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch rows import-verify — Verify imported rows for task_id assertions
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--task-id | string; required | |
--expected-rows | integer | Assert imported row count equals this value |
--require-columns | string; repeatable; comma-separated | Assert required column keys exist (comma-separated; repeatable) |
--duplicate-key | string; repeatable; comma-separated | Assert no duplicates on this identity key (comma-separated; repeatable) |
--require-non-empty | string; repeatable; comma-separated | Assert non-empty ratio by key (key:ratio, comma-separated; repeatable) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch rows import-verify [-h] --table-id TABLE_ID --task-id TASK_ID
[--expected-rows EXPECTED_ROWS]
[--require-columns REQUIRE_COLUMNS]
[--duplicate-key DUPLICATE_KEY]
[--require-non-empty REQUIRE_NON_EMPTY]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch rows list — List table rows with optional filters/sort
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--filters-json | json; input: json | Optional JSON object for server-side filters |
--filters-file | file; input: file | Optional JSON file for server-side filters |
--sort-json | json; input: json | Optional JSON object for server-side sort |
--sort-file | file; input: file | Optional JSON file for server-side sort |
--page-size | integer; default: 50 | Rows per page (1-1000, default 50) |
--cursor | string | Pagination cursor from a previous rows list response |
--parse-json-cells | boolean; when omitted=false; when present=true | Parse stringified JSON object/array cell values before printing output |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch rows list [-h] --table-id TABLE_ID
[--filters-json FILTERS_JSON]
[--filters-file FILTERS_FILE]
[--sort-json SORT_JSON] [--sort-file SORT_FILE]
[--page-size PAGE_SIZE] [--cursor CURSOR]
[--parse-json-cells] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch rows schema — Print row payload schemas for add/import helpers
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, add_records, import_field_mappings; default: "all" | |
--out-file | file; input: file | Write schema JSON to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch rows schema [-h]
[--type {all,add_records,import_field_mappings}]
[--out-file OUT_FILE]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]run
autotouch run — Alias for: columns run
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-id | string; required | |
--scope | string; choices: all, subset, row, firstN, filtered; default: "all" | Run scope: row=one explicit ID, subset=explicit many IDs, filtered=current filters, firstN=first N rows, all=entire table |
--row-id | string | Single row ID for scope=row |
--row-ids | list | Row IDs for subset scope (or a single row when scope=row) |
--first-n | integer | First N rows (for scope=firstN). Use with --unprocessed-only to process the next rows without reruns |
--unprocessed-only | boolean; when omitted=true; when present=true | Only process rows without values (default) |
--include-processed | boolean; when omitted=true; when present=false | Include rows that already have output |
--filters-json | json; input: json | JSON object for scope=filtered |
--filters-file | file; input: file | Path to JSON file for scope=filtered |
--data-json | json; input: json | Explicit RunRequest payload JSON (overrides scope flags) |
--data-file | file; input: file | Path to RunRequest payload JSON file (overrides scope flags) |
--show-estimate | boolean; when omitted=false; when present=true | Include estimate response in output |
--dry-run | boolean; when omitted=false; when present=true | Only estimate; do not execute run |
--max-credits | number | Block run when estimate exceeds this value |
--allow-unknown-max | boolean; when omitted=false; when present=true | Allow run when estimated_credits_max is null (max-credits guard uses min estimate) |
--wait | boolean; when omitted=false; when present=true | Wait for the canonical operation-run terminal status by polling /api/operation-runs/{operation_run_id} |
--quiet-wait | boolean; when omitted=false; when present=true | Suppress per-poll output in --wait mode |
--poll-interval | integer; default: 2 | Polling interval seconds for --wait |
--wait-timeout | integer; default: 0 | Max seconds to wait (0 = no timeout) |
--fail-on-error | boolean; when omitted=false; when present=true | Exit non-zero when final status is error/cancelled |
--fail-on-partial | boolean; when omitted=false; when present=true | Exit non-zero when final status is partial |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --unprocessed-only, --include-processed.
Choose at most one of: --select, --json-pointer.
autotouch run [-h] --table-id TABLE_ID --column-id COLUMN_ID
[--scope {all,subset,row,firstN,filtered}]
[--row-id ROW_ID] [--row-ids [ROW_IDS ...]]
[--first-n FIRST_N]
[--unprocessed-only | --include-processed]
[--filters-json FILTERS_JSON]
[--filters-file FILTERS_FILE] [--data-json DATA_JSON]
[--data-file DATA_FILE] [--show-estimate] [--dry-run]
[--max-credits MAX_CREDITS] [--allow-unknown-max]
[--wait] [--quiet-wait] [--poll-interval POLL_INTERVAL]
[--wait-timeout WAIT_TIMEOUT] [--fail-on-error]
[--fail-on-partial] [--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]run-next
autotouch run-next — Alias for: columns run-next
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-id | string; required | |
--count | integer; required | Maximum number of rows to queue |
--filters-json | json; input: json | Optional JSON object to select from filtered rows |
--filters-file | file; input: file | Optional JSON file to select from filtered rows |
--page-size | integer; default: 200 | Rows page size while selecting candidates (max 1000) |
--include-processed | boolean; when omitted=true; when present=false | Include rows that already have output in candidate selection |
--fail-if-empty | boolean; when omitted=false; when present=true | Exit non-zero when no eligible rows are selected |
--show-estimate | boolean; when omitted=false; when present=true | Include estimate response in output |
--dry-run | boolean; when omitted=false; when present=true | Only estimate; do not execute run |
--max-credits | number | Block run when estimate exceeds this value |
--allow-unknown-max | boolean; when omitted=false; when present=true | Allow run when estimated_credits_max is null (max-credits guard uses min estimate) |
--wait | boolean; when omitted=false; when present=true | Wait for the canonical operation-run terminal status by polling /api/operation-runs/{operation_run_id} |
--quiet-wait | boolean; when omitted=false; when present=true | Suppress per-poll output in --wait mode |
--poll-interval | integer; default: 2 | Polling interval seconds for --wait |
--wait-timeout | integer; default: 0 | Max seconds to wait (0 = no timeout) |
--fail-on-error | boolean; when omitted=false; when present=true | Exit non-zero when final status is error/cancelled |
--fail-on-partial | boolean; when omitted=false; when present=true | Exit non-zero when final status is partial |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch run-next [-h] --table-id TABLE_ID --column-id COLUMN_ID
--count COUNT [--filters-json FILTERS_JSON]
[--filters-file FILTERS_FILE]
[--page-size PAGE_SIZE] [--include-processed]
[--fail-if-empty] [--show-estimate] [--dry-run]
[--max-credits MAX_CREDITS] [--allow-unknown-max]
[--wait] [--quiet-wait]
[--poll-interval POLL_INTERVAL]
[--wait-timeout WAIT_TIMEOUT] [--fail-on-error]
[--fail-on-partial] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]scheduled
autotouch scheduled — Scheduled Chat operations (owner user session required)
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, get, create, update, activate, pause, archive, run-now, runs, get-run, cancel-run, attention, mark-attention-read.
autotouch scheduled [-h]
{list,get,create,update,activate,pause,archive,run-now,runs,get-run,cancel-run,attention,mark-attention-read}
...autotouch scheduled activate — Activate a reviewed Scheduled Chat definition
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Activate a reviewed Scheduled Chat definition. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
schedule_id | string; required | |
--data-json | json; input: json | HTTP request body as JSON |
--data-file | file; input: file | Path to HTTP request body JSON (use - for stdin) |
--expected-version | integer | Current version from scheduled get; alternatively expectedVersion in JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch scheduled activate [-h]
[--data-json DATA_JSON | --data-file DATA_FILE]
[--expected-version EXPECTED_VERSION]
[--base-url BASE_URL] [--token TOKEN]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
schedule_idautotouch scheduled archive — Archive an owned Scheduled Chat definition
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Archive an owned Scheduled Chat definition. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
schedule_id | string; required | |
--data-json | json; input: json | HTTP request body as JSON |
--data-file | file; input: file | Path to HTTP request body JSON (use - for stdin) |
--expected-version | integer | Current version from scheduled get; alternatively expectedVersion in JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch scheduled archive [-h]
[--data-json DATA_JSON | --data-file DATA_FILE]
[--expected-version EXPECTED_VERSION]
[--base-url BASE_URL] [--token TOKEN]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
schedule_idautotouch scheduled attention — List your Scheduled Chat attention items
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
List your Scheduled Chat attention items. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
--unread-only | boolean; when omitted=null; when present=true | |
--limit | integer | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch scheduled attention [-h] [--unread-only] [--limit LIMIT]
[--base-url BASE_URL] [--token TOKEN]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch scheduled cancel-run — Request cancellation of a Scheduled Chat occurrence
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Request cancellation of a Scheduled Chat occurrence. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
schedule_id | string; required | |
occurrence_id | string; required | |
--data-json | json; input: json | HTTP request body as JSON |
--data-file | file; input: file | Path to HTTP request body JSON (use - for stdin) |
--reason | string | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch scheduled cancel-run [-h]
[--data-json DATA_JSON | --data-file DATA_FILE]
[--reason REASON] [--base-url BASE_URL]
[--token TOKEN] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
schedule_id occurrence_idautotouch scheduled create — Create a draft Scheduled Chat definition
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Create a draft Scheduled Chat definition. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | ScheduleCreateRequest: name, prompt, recurrence {rrule, timezone}; optional resourceRefs and standingApprovalGrantId as JSON |
--data-file | file; input: file | Path to ScheduleCreateRequest: name, prompt, recurrence {rrule, timezone}; optional resourceRefs and standingApprovalGrantId JSON (use - for stdin) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose exactly one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch scheduled create [-h]
(--data-json DATA_JSON | --data-file DATA_FILE)
[--base-url BASE_URL] [--token TOKEN]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch scheduled get — Read one owned Scheduled Chat definition
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Read one owned Scheduled Chat definition. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
schedule_id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch scheduled get [-h] [--base-url BASE_URL] [--token TOKEN]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
schedule_idautotouch scheduled get-run — Read one exact Scheduled Chat occurrence
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Read one exact Scheduled Chat occurrence. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
schedule_id | string; required | |
occurrence_id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch scheduled get-run [-h] [--base-url BASE_URL] [--token TOKEN]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
schedule_id occurrence_idautotouch scheduled list — List your Scheduled Chat definitions
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
List your Scheduled Chat definitions. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
--status | string; repeatable; choices: draft, active, paused, completed, archived | |
--limit | integer | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch scheduled list [-h]
[--status {draft,active,paused,completed,archived}]
[--limit LIMIT] [--base-url BASE_URL]
[--token TOKEN] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch scheduled mark-attention-read — Mark one owned Scheduled Chat attention item read
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Mark one owned Scheduled Chat attention item read. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
attention_id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch scheduled mark-attention-read [-h] [--base-url BASE_URL]
[--token TOKEN]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
attention_idautotouch scheduled pause — Pause an owned Scheduled Chat definition
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Pause an owned Scheduled Chat definition. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
schedule_id | string; required | |
--data-json | json; input: json | HTTP request body as JSON |
--data-file | file; input: file | Path to HTTP request body JSON (use - for stdin) |
--expected-version | integer | Current version from scheduled get; alternatively expectedVersion in JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch scheduled pause [-h]
[--data-json DATA_JSON | --data-file DATA_FILE]
[--expected-version EXPECTED_VERSION]
[--base-url BASE_URL] [--token TOKEN]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
schedule_idautotouch scheduled run-now — Queue one idempotent Scheduled Chat occurrence
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Queue one idempotent Scheduled Chat occurrence. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
schedule_id | string; required | |
--data-json | json; input: json | HTTP request body as JSON |
--data-file | file; input: file | Path to HTTP request body JSON (use - for stdin) |
--expected-version | integer | Current version from scheduled get; alternatively expectedVersion in JSON |
--idempotency-key | string | Stable retry key, 8-200 characters |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch scheduled run-now [-h]
[--data-json DATA_JSON | --data-file DATA_FILE]
[--expected-version EXPECTED_VERSION]
[--idempotency-key IDEMPOTENCY_KEY]
[--base-url BASE_URL] [--token TOKEN]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
schedule_idautotouch scheduled runs — List occurrences for an owned schedule
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
List occurrences for an owned schedule. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
schedule_id | string; required | |
--limit | integer | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch scheduled runs [-h] [--limit LIMIT] [--base-url BASE_URL]
[--token TOKEN] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
schedule_idautotouch scheduled update — Update an owned Scheduled Chat definition with version protection
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Update an owned Scheduled Chat definition with version protection. Requires a user session (`autotouch auth login`); developer keys are not supported.
| Argument | Contract | Description |
|---|---|---|
schedule_id | string; required | |
--data-json | json; input: json | ScheduleUpdateRequest: expectedVersion plus name, prompt, recurrence, or resourceRefs as JSON |
--data-file | file; input: file | Path to ScheduleUpdateRequest: expectedVersion plus name, prompt, recurrence, or resourceRefs JSON (use - for stdin) |
--expected-version | integer | Current version from scheduled get; alternatively expectedVersion in JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | User session token (defaults to the saved user session) |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose exactly one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch scheduled update [-h]
(--data-json DATA_JSON | --data-file DATA_FILE)
[--expected-version EXPECTED_VERSION]
[--base-url BASE_URL] [--token TOKEN]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]
schedule_idschema
autotouch schema — Print shared descriptor schemas used across commands
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, filter_descriptor, sort_spec, run_request, selection_descriptor; default: "all" | |
--out-file | file; input: file | Write schema JSON to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch schema [-h]
[--type {all,filter_descriptor,sort_spec,run_request,selection_descriptor}]
[--out-file OUT_FILE] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]search
autotouch search — Provider-hidden search operations
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: board-jobs, catalog-companies, people-basic, linkedin-posts, linkedin-post-engagers, role-changes, recipe, companies, people, similar-companies, web, web-results, read-url, company-profile, person-profile, news, local-businesses, reviews, filings.
autotouch search [-h]
{board-jobs,catalog-companies,people-basic,linkedin-posts,linkedin-post-engagers,role-changes,recipe,companies,people,similar-companies,web,web-results,read-url,company-profile,person-profile,news,local-businesses,reviews,filings}
...autotouch search board-jobs — Search a selected jobs board without creating a durable list job (limit 1-25)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Search a selected jobs board without creating a durable list job (limit 1-25)
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | BoardJobsSearchRequest: query; optional board (indeed/google/linkedin), location, country, language, limit, date_posted, job_type, sort, page_token as JSON |
--data-file | file; input: file | Path to BoardJobsSearchRequest: query; optional board (indeed/google/linkedin), location, country, language, limit, date_posted, job_type, sort, page_token JSON (use - for stdin) |
--query | string | |
--board | string; choices: indeed, google, linkedin | |
--location | string | |
--country | string | |
--limit | integer | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch search board-jobs [-h]
[--data-json DATA_JSON | --data-file DATA_FILE]
[--query QUERY]
[--board {indeed,google,linkedin}]
[--location LOCATION] [--country COUNTRY]
[--limit LIMIT] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search catalog-companies — Search a bounded company catalog snapshot using deterministic filters (limit 1-25)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Search a bounded company catalog snapshot using deterministic filters (limit 1-25)
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | CatalogCompaniesSearchRequest: at least one industry/geography/size/founded-year filter; require_domain=true; limit 1-25 as JSON |
--data-file | file; input: file | Path to CatalogCompaniesSearchRequest: at least one industry/geography/size/founded-year filter; require_domain=true; limit 1-25 JSON (use - for stdin) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose exactly one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch search catalog-companies [-h]
(--data-json DATA_JSON | --data-file DATA_FILE)
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search companies — Find companies with Exa Company Search
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--query | string | Natural-language company query |
--limit | integer; default: 10 | Max results, 1-100 (default: 10) |
--data-json | json; input: json | Explicit request payload JSON |
--data-file | file; input: file | Path to request payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch search companies [-h] [--query QUERY] [--limit LIMIT]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search company-profile — Look up one exact company profile through LeadMagic
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--company-name | string | |
--company-domain | string | |
--linkedin-url | string | |
--data-json | json; input: json | Explicit request payload JSON |
--data-file | file; input: file | Path to request payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch search company-profile [-h] [--company-name COMPANY_NAME]
[--company-domain COMPANY_DOMAIN]
[--linkedin-url LINKEDIN_URL]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search filings — Research public company filings
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--company-name | string | Public company name |
--filing-type | string; repeatable; comma-separated | Filing type (repeatable; comma-separated also supported) |
--data-json | json; input: json | Explicit request payload JSON |
--data-file | file; input: file | Path to request payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch search filings [-h] [--company-name COMPANY_NAME]
[--filing-type FILING_TYPE]
[--data-json DATA_JSON]
[--data-file DATA_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search linkedin-post-engagers — Read comments/reactions for up to 12 exact LinkedIn posts
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Read comments/reactions for up to 12 exact LinkedIn posts
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | LinkedInPostEngagersSearchRequest: posts [{post_id or post_url}], engagement_types [comments, reactions], limit_per_type 1-25 as JSON |
--data-file | file; input: file | Path to LinkedInPostEngagersSearchRequest: posts [{post_id or post_url}], engagement_types [comments, reactions], limit_per_type 1-25 JSON (use - for stdin) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose exactly one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch search linkedin-post-engagers [-h]
(--data-json DATA_JSON | --data-file DATA_FILE)
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search linkedin-posts — Discover LinkedIn posts from a query or up to five company pages (limit 1-12)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Discover LinkedIn posts from a query or up to five company pages (limit 1-12)
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | HTTP request body as JSON |
--data-file | file; input: file | Path to HTTP request body JSON (use - for stdin) |
--query | string | |
--company-page | string; repeatable | |
--limit | integer | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch search linkedin-posts [-h]
[--data-json DATA_JSON | --data-file DATA_FILE]
[--query QUERY]
[--company-page COMPANY_PAGE]
[--limit LIMIT] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search local-businesses — Search local businesses
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--query | string | Local business query |
--limit | integer; default: 25 | Max results, 1-100 (default: 25) |
--country | string; default: "us" | Country code (default: us) |
--language | string; default: "en" | Language code (default: en) |
--page | integer; default: 1 | Page number (default: 1) |
--area | string; repeatable | Explicit geographic cell; repeat up to 10 times |
--area-type | string; choices: postal_code, postal_district, locality, custom; default: "postal_code" | Type applied to every --area value (default: postal_code) |
--max-queries | integer; default: 10 | Maximum provider calls for this request, 1-10 (default: 10) |
--csv-file | file; input: file | Write normalized unique result items to an import-ready CSV file |
--data-json | json; input: json | Explicit request payload JSON |
--data-file | file; input: file | Path to request payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch search local-businesses [-h] [--query QUERY] [--limit LIMIT]
[--country COUNTRY]
[--language LANGUAGE] [--page PAGE]
[--area AREA]
[--area-type {postal_code,postal_district,locality,custom}]
[--max-queries MAX_QUERIES]
[--csv-file CSV_FILE]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search news — Search recent news
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--query | string | News query |
--days-back | integer; default: 7 | Lookback window in days (default: 7) |
--limit | integer; default: 25 | Max results, 1-100 (default: 25) |
--data-json | json; input: json | Explicit request payload JSON |
--data-file | file; input: file | Path to request payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch search news [-h] [--query QUERY] [--days-back DAYS_BACK]
[--limit LIMIT] [--data-json DATA_JSON]
[--data-file DATA_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search people — Find people with provider-hidden neural search
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--person-description | string | Required semantic person/responsibility description, e.g. 'person responsible for endpoint management' |
--query | string | Deprecated alias for --person-description |
--company | string | Optional company name |
--domain | string | Optional company domain anchor |
--location | string | Optional location |
--limit | integer; default: 10 | Max results, 1-10 (default: 10) |
--data-json | json; input: json | Explicit request payload JSON |
--data-file | file; input: file | Path to request payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch search people [-h] [--person-description PERSON_DESCRIPTION]
[--query QUERY] [--company COMPANY]
[--domain DOMAIN] [--location LOCATION]
[--limit LIMIT] [--data-json DATA_JSON]
[--data-file DATA_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search people-basic — Find public LinkedIn profiles with explicit keywords (limit 1-10)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Find public LinkedIn profiles with explicit keywords (limit 1-10)
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | HTTP request body as JSON |
--data-file | file; input: file | Path to HTTP request body JSON (use - for stdin) |
--query | string | |
--limit | integer | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch search people-basic [-h]
[--data-json DATA_JSON | --data-file DATA_FILE]
[--query QUERY] [--limit LIMIT]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search person-profile — Look up one exact LinkedIn person profile through LinkdAPI
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--linkedin-url | string | |
--username | string | |
--urn | string | |
--data-json | json; input: json | Explicit request payload JSON |
--data-file | file; input: file | Path to request payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch search person-profile [-h] [--linkedin-url LINKEDIN_URL]
[--username USERNAME] [--urn URN]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search read-url — Read bounded evidence from one public URL or uploaded PDF
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--url | string | Public HTML or PDF URL |
--attachment-id | string | Organization-scoped Command Center uploaded-PDF id |
--purpose | string; choices: default, business_contact_info, people, dom; default: "default" | |
--no-links | boolean; when omitted=false; when present=true | |
--include-images | boolean; when omitted=false; when present=true | |
--max-content-chars | integer; default: 80000 | |
--max-raw-html-chars | integer; default: 300000 | |
--max-pdf-bytes | integer | |
--max-pdf-pages | integer | |
--pdf-page-start | integer | |
--data-json | json; input: json | Explicit request payload JSON |
--data-file | file; input: file | Path to request payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --url, --attachment-id.
Choose at most one of: --select, --json-pointer.
autotouch search read-url [-h]
[--url URL | --attachment-id ATTACHMENT_ID]
[--purpose {default,business_contact_info,people,dom}]
[--no-links] [--include-images]
[--max-content-chars MAX_CONTENT_CHARS]
[--max-raw-html-chars MAX_RAW_HTML_CHARS]
[--max-pdf-bytes MAX_PDF_BYTES]
[--max-pdf-pages MAX_PDF_PAGES]
[--pdf-page-start PDF_PAGE_START]
[--data-json DATA_JSON]
[--data-file DATA_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search recipe — Print search payload recipes
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, companies, people, similar_companies, news, local_businesses, reviews, filings; default: "all" | |
--out-file | file; input: file | Optional path to save the selected payload JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch search recipe [-h]
[--type {all,companies,people,similar_companies,news,local_businesses,reviews,filings}]
[--out-file OUT_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search reviews — Fetch reviews for a known listing
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--cid | string | Listing CID |
--place-id | string | Listing place_id |
--fid | string | Listing fid |
--sort-by | string; default: "newest" | Sort order (default: newest) |
--limit | integer; default: 25 | Max results, 1-100 (default: 25) |
--country | string; default: "us" | Country code (default: us) |
--language | string; default: "en" | Language code (default: en) |
--next-page-token | string; sensitive | Pagination token |
--page | integer; default: 1 | Page number (default: 1) |
--data-json | json; input: json | Explicit request payload JSON |
--data-file | file; input: file | Path to request payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch search reviews [-h] [--cid CID] [--place-id PLACE_ID]
[--fid FID] [--sort-by SORT_BY]
[--limit LIMIT] [--country COUNTRY]
[--language LANGUAGE]
[--next-page-token NEXT_PAGE_TOKEN]
[--page PAGE] [--data-json DATA_JSON]
[--data-file DATA_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search role-changes — Unlock bounded role changes using supported position filters (limit 1-5)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Unlock bounded role changes using supported position filters (limit 1-5)
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | HTTP request body as JSON |
--data-file | file; input: file | Path to HTTP request body JSON (use - for stdin) |
--position | string; repeatable | |
--country | string; repeatable | |
--date-preset | string | |
--limit | integer | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch search role-changes [-h]
[--data-json DATA_JSON | --data-file DATA_FILE]
[--position POSITION] [--country COUNTRY]
[--date-preset DATE_PRESET]
[--limit LIMIT] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search similar-companies — Find companies similar to a seed company
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--query | string | Required exact semantic company query; distinguish the vendor from its customers, name the buyer and workflow, and add useful near-neighbor exclusions |
--company-name | string | Optional seed company name to exclude from results |
--company-domain | string | Optional official seed domain to exclude from results |
--limit | integer; default: 10 | Max results, 1-100 (default: 10) |
--data-json | json; input: json | Explicit request payload JSON |
--data-file | file; input: file | Path to request payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch search similar-companies [-h] [--query QUERY]
[--company-name COMPANY_NAME]
[--company-domain COMPANY_DOMAIN]
[--limit LIMIT]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search web — Run bounded live web research through Parallel
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--objective | string; required | Research objective |
--query | string; repeatable | Search query; repeat up to three times (defaults to the objective) |
--mode | string; choices: turbo, basic, advanced; default: "basic" | |
--max-chars-total | integer | |
--include-domain | string; repeatable | |
--exclude-domain | string; repeatable | |
--after-date | string | Provider-supported date lower bound |
--country | string | Two-letter country code |
--data-json | json; input: json | Explicit request payload JSON |
--data-file | file; input: file | Path to request payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch search web [-h] --objective OBJECTIVE [--query QUERY]
[--mode {turbo,basic,advanced}]
[--max-chars-total MAX_CHARS_TOTAL]
[--include-domain INCLUDE_DOMAIN]
[--exclude-domain EXCLUDE_DOMAIN]
[--after-date AFTER_DATE] [--country COUNTRY]
[--data-json DATA_JSON] [--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch search web-results — Discover live Google result links and snippets through Serper
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--query | string; required | Search query |
--limit | integer; default: 10 | Max results, 1-10 (default: 10) |
--data-json | json; input: json | Explicit request payload JSON |
--data-file | file; input: file | Path to request payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch search web-results [-h] --query QUERY [--limit LIMIT]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]sender-accounts
autotouch sender-accounts — List connected email and LinkedIn sender accounts
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, get, set-default, grant-delegation, revoke-delegation.
Read sender accounts available to the current actor. Most sequence enrollments only need an assignee and will use that user's default connected senders. Use these IDs when the task owner/reviewer differs from the email or LinkedIn sender, for round-robin routing, or for sender-account delegation management.
autotouch sender-accounts [-h]
{list,get,set-default,grant-delegation,revoke-delegation}
...autotouch sender-accounts get — Get one sender account and its delegations
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sender-account-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sender-accounts get [-h] --sender-account-id
SENDER_ACCOUNT_ID [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sender-accounts grant-delegation — Allow another user to send from a sender account
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Owner/admin user-session management command. Use when one user's connected account should be available for another workspace user to manage or execute assigned sequence work.
| Argument | Contract | Description |
|---|---|---|
--sender-account-id | string; required | |
--delegate-user-id | string; required | |
--scope | string; repeatable | Delegation scope (default: send); repeatable |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sender-accounts grant-delegation [-h] --sender-account-id
SENDER_ACCOUNT_ID
--delegate-user-id
DELEGATE_USER_ID
[--scope SCOPE]
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sender-accounts list — List accessible sender accounts
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--channel | string; choices: email, linkedin | Filter by sender channel |
--include-all | boolean; when omitted=false; when present=true | Admin only: include all sender accounts in the organization, useful when resolving explicit team-managed senders |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sender-accounts list [-h] [--channel {email,linkedin}]
[--include-all] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sender-accounts revoke-delegation — Revoke another user's access to a sender account
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Owner/admin user-session management command for sender account delegation cleanup.
| Argument | Contract | Description |
|---|---|---|
--sender-account-id | string; required | |
--delegate-user-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sender-accounts revoke-delegation [-h] --sender-account-id
SENDER_ACCOUNT_ID
--delegate-user-id
DELEGATE_USER_ID
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sender-accounts set-default — Set the owner/default sender account for its channel
Auth: user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Owner/admin user-session management command. Connecting accounts still happens in Settings > Accounts; this command selects the default sender when multiple accounts exist.
| Argument | Contract | Description |
|---|---|---|
--sender-account-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sender-accounts set-default [-h] --sender-account-id
SENDER_ACCOUNT_ID
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]sequences
autotouch sequences — Sequence management and enrollment
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: table-readiness, list, get, stats, delivery-status, variable-catalog, recipe, create, update, sync-accounts, delete, clone, status, activate, pause, archive, enroll, preview-audience, preview-draft, resolve-draft, update-draft, learn-draft, transfer-ownership, pause-enrollment.
autotouch sequences [-h]
{table-readiness,list,get,stats,delivery-status,variable-catalog,recipe,create,update,sync-accounts,delete,clone,status,activate,pause,archive,enroll,preview-audience,preview-draft,resolve-draft,update-draft,learn-draft,transfer-ownership,pause-enrollment}
...autotouch sequences activate — Activate a sequence
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences activate [-h] --sequence-id SEQUENCE_ID
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences archive — Archive a sequence
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences archive [-h] --sequence-id SEQUENCE_ID
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences clone — Clone a sequence into a new DRAFT
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--name | string | Optional name for the cloned DRAFT |
--target-source-table-id | string | Optional Research Table id to associate with the clone |
--target-source-table-name | string | Optional display name for --target-source-table-id |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences clone [-h] --sequence-id SEQUENCE_ID [--name NAME]
[--target-source-table-id TARGET_SOURCE_TABLE_ID]
[--target-source-table-name TARGET_SOURCE_TABLE_NAME]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences create — Create a sequence from a JSON payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Sequence create payload JSON |
--data-file | file; input: file | Sequence create payload file path |
--bulk-provider | string; choices: instantly, smartlead | Set sequence emailDelivery to bulk mode with this provider |
--account-selection | string; choices: all_eligible, selected | Bulk provider sender pool: all eligible org accounts or selected account emails |
--selected-account | string; repeatable; comma-separated | Bulk provider sender email for --account-selection selected; repeatable or comma-separated |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences create [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--bulk-provider {instantly,smartlead}]
[--account-selection {all_eligible,selected}]
[--selected-account SELECTED_ACCOUNT]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences delete — Delete a DRAFT or ARCHIVED sequence
Auth: developer_key_or_user_session. Stability: stable. Destructive: yes.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--yes | boolean; when omitted=false; when present=true | Required confirmation flag for destructive delete |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences delete [-h] --sequence-id SEQUENCE_ID [--yes]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences delivery-status — Check sequence email delivery readiness
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences delivery-status [-h] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences enroll — Enroll leads into a sequence (best for one-off/manual adds)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human. Supports streaming progress.
Direct enroll is best for one-off/manual adds. The simple path is lead IDs plus --assigned-to-user-id, which is the task owner/reviewer. When sender account flags are omitted, execution uses that user's default connected email/LinkedIn senders. For team-managed work, keep --assigned-to-user-id as the manager/reviewer and pass --email-sender-account-id / --linkedin-sender-account-id for the account that should actually send. Use add_to_sequence when rows should auto-enroll from a research table over time.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--idempotency-key | string | Override the automatically derived request key; reuse it only with identical input. Same-key replay is guaranteed only when the server response acknowledges idempotency_key_honored=true |
--data-json | json; input: json | Full enroll payload JSON (advanced; overrides simpler flags) |
--data-file | file; input: file | Full enroll payload JSON file (advanced; overrides simpler flags) |
--lead-id | string; repeatable; comma-separated | Lead id to enroll (repeatable; comma-separated also supported) |
--lead-ids-json | json; input: json | JSON array or object with leadIds[] |
--lead-ids-file | file; input: file | Path to JSON/TXT/CSV file with lead ids |
--lead-ids-column | string; default: "lead_id" | CSV column for lead ids (default: lead_id) |
--start-date | string | Optional startDate ISO timestamp |
--research-context-json, --attach-research-context-json | json; input: json | Advanced raw researchContext JSON for workflow-scoped table context |
--research-context-file, --attach-research-context-file | file; input: file | Advanced raw researchContext JSON file for workflow-scoped table context |
--attach-research-table-id | string | Attach research context from this table for later tasks, sidecar views, and AI drafts |
--attach-research-table-name | string | Optional source table name to store alongside attached research context |
--attach-research-field-id | string; repeatable; comma-separated | Optional research field id to keep in attached context (repeatable; comma-separated also supported) |
--variable-map-json | json; input: json | variableMap JSON |
--variable-map-file | file; input: file | variableMap JSON file |
--variable-overrides-json | json; input: json | variableOverrides JSON |
--variable-overrides-file | file; input: file | variableOverrides JSON file |
--assigned-to-user-id | string | Task owner/reviewer. Default senders for that user are used unless sender routing flags are supplied |
--email-sender-account-id | string | Advanced: pin personal email steps to this sender account instead of using the assignee's default |
--linkedin-sender-account-id | string | Advanced: pin LinkedIn steps to this sender account instead of using the assignee's default |
--sender-account | string; repeatable; comma-separated | Advanced sender mapping channel=id (email=... or linkedin=...); repeatable, comma-separated |
--assignment-plan-json | json; input: json | Advanced: assignmentPlan JSON array for team/round-robin routing |
--assignment-plan-file | file; input: file | Advanced: assignmentPlan JSON file for team/round-robin routing |
--routing-mode | string; choices: single, round_robin, weighted_round_robin | Advanced: routing mode for assignmentPlan |
--update-lead-owner | boolean; when omitted=false; when present=true | Also update Lead.user_id to the assignee |
--review-only | boolean; when omitted=false; when present=true | Create paused review-only enrollments |
--skip-active-sequence-conflicts | boolean; when omitted=false; when present=true | Skip leads already active in another sequence |
--wait | boolean; when omitted=false; when present=true | Wait for enrollment bulk job terminal status |
--quiet-wait | boolean; when omitted=false; when present=true | Suppress per-poll output in --wait mode |
--poll-interval | integer; default: 2 | Polling interval seconds for --wait |
--wait-timeout | integer; default: 0 | Max seconds to wait (0 = no timeout) |
--fail-on-error | boolean; when omitted=false; when present=true | Exit non-zero when final status is error/cancelled |
--fail-on-partial | boolean; when omitted=false; when present=true | Exit non-zero when final status is partial |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences enroll [-h] --sequence-id SEQUENCE_ID
[--idempotency-key IDEMPOTENCY_KEY]
[--data-json DATA_JSON]
[--data-file DATA_FILE] [--lead-id LEAD_ID]
[--lead-ids-json LEAD_IDS_JSON]
[--lead-ids-file LEAD_IDS_FILE]
[--lead-ids-column LEAD_IDS_COLUMN]
[--start-date START_DATE]
[--research-context-json RESEARCH_CONTEXT_JSON]
[--research-context-file RESEARCH_CONTEXT_FILE]
[--attach-research-table-id ATTACH_RESEARCH_TABLE_ID]
[--attach-research-table-name ATTACH_RESEARCH_TABLE_NAME]
[--attach-research-field-id ATTACH_RESEARCH_FIELD_ID]
[--variable-map-json VARIABLE_MAP_JSON]
[--variable-map-file VARIABLE_MAP_FILE]
[--variable-overrides-json VARIABLE_OVERRIDES_JSON]
[--variable-overrides-file VARIABLE_OVERRIDES_FILE]
[--assigned-to-user-id ASSIGNED_TO_USER_ID]
[--email-sender-account-id EMAIL_SENDER_ACCOUNT_ID]
[--linkedin-sender-account-id LINKEDIN_SENDER_ACCOUNT_ID]
[--sender-account SENDER_ACCOUNT]
[--assignment-plan-json ASSIGNMENT_PLAN_JSON]
[--assignment-plan-file ASSIGNMENT_PLAN_FILE]
[--routing-mode {single,round_robin,weighted_round_robin}]
[--update-lead-owner] [--review-only]
[--skip-active-sequence-conflicts] [--wait]
[--quiet-wait]
[--poll-interval POLL_INTERVAL]
[--wait-timeout WAIT_TIMEOUT]
[--fail-on-error] [--fail-on-partial]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences get — Get one sequence
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences get [-h] --sequence-id SEQUENCE_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences learn-draft — Capture edits from a reviewed draft preview
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--lead-id | string | Lead id used by the reviewed draft |
--step-id | string | Sequence step id used by the reviewed draft |
--original-content-json | json; input: json | Original generated content JSON |
--original-content-file | file; input: file | Path to original content JSON |
--edited-content-json | json; input: json | Final edited content JSON |
--edited-content-file | file; input: file | Path to final edited content JSON |
--draft-meta-json | json; input: json | Optional draft metadata JSON |
--draft-meta-file | file; input: file | Path to optional draft metadata JSON |
--draft-type | string | Optional draft type |
--data-json | json; input: json | Full learning payload JSON; overrides individual flags |
--data-file | file; input: file | Path to full learning payload JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences learn-draft [-h] --sequence-id SEQUENCE_ID
[--lead-id LEAD_ID] [--step-id STEP_ID]
[--original-content-json ORIGINAL_CONTENT_JSON]
[--original-content-file ORIGINAL_CONTENT_FILE]
[--edited-content-json EDITED_CONTENT_JSON]
[--edited-content-file EDITED_CONTENT_FILE]
[--draft-meta-json DRAFT_META_JSON]
[--draft-meta-file DRAFT_META_FILE]
[--draft-type DRAFT_TYPE]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences list — List sequences
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--status | string | Filter by status (DRAFT/ACTIVE/PAUSED/ARCHIVED) |
--source-table-id | string | Filter by source table id |
--include-stats | boolean; when omitted=false; when present=true | Include live enrollment stats per sequence |
--limit | integer; default: 50 | Max sequences to return (1-100) |
--offset | integer; default: 0 | Pagination offset |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences list [-h] [--status STATUS]
[--source-table-id SOURCE_TABLE_ID]
[--include-stats] [--limit LIMIT]
[--offset OFFSET] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences pause — Pause a sequence
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences pause [-h] --sequence-id SEQUENCE_ID
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences pause-enrollment — Pause one lead's enrollment in a sequence
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--lead-id | string; required | |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences pause-enrollment [-h] --sequence-id SEQUENCE_ID
--lead-id LEAD_ID
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences preview-audience — Preview sequence audience hydration without creating enrollments
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--data-json | json; input: json | Full SequenceAudiencePreviewIn payload JSON |
--data-file | file; input: file | Full SequenceAudiencePreviewIn payload file |
--lead-id | string; repeatable | Lead id to preview; repeatable |
--lead-ids-json | json; input: json | JSON array or object with leadIds[] |
--lead-ids-file | file; input: file | Path to JSON/TXT/CSV file with lead ids |
--lead-ids-column | string; default: "lead_id" | CSV column for lead ids |
--research-context-json | json; input: json | Optional researchContext JSON |
--research-context-file | file; input: file | Optional researchContext JSON file |
--variable-map-json | json; input: json | Optional variableMap JSON |
--variable-map-file | file; input: file | Optional variableMap JSON file |
--limit | integer; default: 200 | Maximum preview rows (1-500) |
--offset | integer; default: 0 | Preview pagination offset |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences preview-audience [-h] --sequence-id SEQUENCE_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--lead-id LEAD_ID]
[--lead-ids-json LEAD_IDS_JSON]
[--lead-ids-file LEAD_IDS_FILE]
[--lead-ids-column LEAD_IDS_COLUMN]
[--research-context-json RESEARCH_CONTEXT_JSON]
[--research-context-file RESEARCH_CONTEXT_FILE]
[--variable-map-json VARIABLE_MAP_JSON]
[--variable-map-file VARIABLE_MAP_FILE]
[--limit LIMIT] [--offset OFFSET]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences preview-draft — Generate a one-off AI draft preview
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--lead-id | string | Lead id to draft for |
--step-id | string | AI-draft-enabled sequence step id |
--variables-json | json; input: json | Variable snapshot JSON object |
--variables-file | file; input: file | Path to variable snapshot JSON |
--variable-map-json | json; input: json | Variable-map JSON object |
--variable-map-file | file; input: file | Path to variable-map JSON |
--research-context-json | json; input: json | Research context JSON object |
--research-context-file | file; input: file | Path to research context JSON |
--research-row-id | string | Optional source Research Table row id |
--data-json | json; input: json | Full endpoint payload JSON; overrides individual flags |
--data-file | file; input: file | Path to full endpoint payload JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences preview-draft [-h] --sequence-id SEQUENCE_ID
[--lead-id LEAD_ID]
[--step-id STEP_ID]
[--variables-json VARIABLES_JSON]
[--variables-file VARIABLES_FILE]
[--variable-map-json VARIABLE_MAP_JSON]
[--variable-map-file VARIABLE_MAP_FILE]
[--research-context-json RESEARCH_CONTEXT_JSON]
[--research-context-file RESEARCH_CONTEXT_FILE]
[--research-row-id RESEARCH_ROW_ID]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences recipe — Print copy-ready sequence payload templates
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, create, manual_review, automated_template, bulk_automated, linkedin_outreach, research_field_routing, enroll; default: "all" | |
--out-file | file; input: file | Write template JSON to file (single type writes payload only) |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch sequences recipe [-h]
[--type {all,create,manual_review,automated_template,bulk_automated,linkedin_outreach,research_field_routing,enroll}]
[--out-file OUT_FILE]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch sequences resolve-draft — Create or reuse a persisted draft preview instance
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--lead-id | string | Lead id to draft for |
--step-id | string | AI-draft-enabled sequence step id |
--variables-json | json; input: json | Variable snapshot JSON object |
--variables-file | file; input: file | Path to variable snapshot JSON |
--variable-map-json | json; input: json | Variable-map JSON object |
--variable-map-file | file; input: file | Path to variable-map JSON |
--research-context-json | json; input: json | Research context JSON object |
--research-context-file | file; input: file | Path to research context JSON |
--research-row-id | string | Optional source Research Table row id |
--data-json | json; input: json | Full endpoint payload JSON; overrides individual flags |
--data-file | file; input: file | Path to full endpoint payload JSON |
--force | boolean; when omitted=false; when present=true | Regenerate even when an instance exists |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences resolve-draft [-h] --sequence-id SEQUENCE_ID
[--lead-id LEAD_ID]
[--step-id STEP_ID]
[--variables-json VARIABLES_JSON]
[--variables-file VARIABLES_FILE]
[--variable-map-json VARIABLE_MAP_JSON]
[--variable-map-file VARIABLE_MAP_FILE]
[--research-context-json RESEARCH_CONTEXT_JSON]
[--research-context-file RESEARCH_CONTEXT_FILE]
[--research-row-id RESEARCH_ROW_ID]
[--data-json DATA_JSON]
[--data-file DATA_FILE] [--force]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences stats — Get live stats for one sequence
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences stats [-h] --sequence-id SEQUENCE_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences status — Set sequence status
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--status | string; required; choices: ACTIVE, PAUSED, ARCHIVED | |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences status [-h] --sequence-id SEQUENCE_ID --status
{ACTIVE,PAUSED,ARCHIVED}
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences sync-accounts — Choose and sync Instantly/Smartlead sender accounts for a managed bulk sequence
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
For bulk sequences, sender accounts live on the provider campaign rather than per enrollment. Use --account-selection all_eligible for the org's eligible provider account group, or --account-selection selected with --selected-account for specific mailbox emails. This is separate from personal email/LinkedIn senderAccountIds used by sequence enrollments.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--account-selection | string; choices: all_eligible, selected; default: "all_eligible" | |
--selected-account | string; repeatable; comma-separated | Provider sender email when --account-selection selected; repeatable or comma-separated |
--no-refresh | boolean; when omitted=false; when present=true | Use cached provider account snapshot |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences sync-accounts [-h] --sequence-id SEQUENCE_ID
[--account-selection {all_eligible,selected}]
[--selected-account SELECTED_ACCOUNT]
[--no-refresh]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences table-readiness — Read linked-table audience readiness without enrollment (sequences:read, tables:read, leads:read)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Read linked-table audience readiness without enrollment (sequences:read, tables:read, leads:read)
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--source-lead-column | string | Exact Sync to Leads result-column key from the linked table |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences table-readiness [-h] --sequence-id SEQUENCE_ID
[--source-lead-column SOURCE_LEAD_COLUMN]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences transfer-ownership — Preview or execute task/enrollment ownership transfer
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--new-user-id | string | Target owner user id |
--lead-id | string; repeatable | Lead id to transfer; repeatable |
--enrollment-id | string; repeatable | Enrollment id to transfer; repeatable |
--mode | string; choices: tasks_only, tasks_plus_enrollment, exit_and_reenroll; default: "tasks_only" | |
--update-lead-owner | boolean; when omitted=false; when present=true | Also change Lead ownership |
--execute | boolean; when omitted=false; when present=true | Apply the transfer; default is dry-run preview |
--data-json | json; input: json | Full transfer payload JSON; selection flags are ignored |
--data-file | file; input: file | Path to full transfer payload JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences transfer-ownership [-h] --sequence-id SEQUENCE_ID
[--new-user-id NEW_USER_ID]
[--lead-id LEAD_ID]
[--enrollment-id ENROLLMENT_ID]
[--mode {tasks_only,tasks_plus_enrollment,exit_and_reenroll}]
[--update-lead-owner]
[--execute]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences update — Update a sequence from a JSON payload (schedule changes may rewindow unsent scheduled work)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--data-json | json; input: json | Sequence update payload JSON |
--data-file | file; input: file | Sequence update payload file path |
--bulk-provider | string; choices: instantly, smartlead | Set sequence emailDelivery to bulk mode with this provider |
--account-selection | string; choices: all_eligible, selected | Bulk provider sender pool: all eligible org accounts or selected account emails |
--selected-account | string; repeatable; comma-separated | Bulk provider sender email for --account-selection selected; repeatable or comma-separated |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences update [-h] --sequence-id SEQUENCE_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--bulk-provider {instantly,smartlead}]
[--account-selection {all_eligible,selected}]
[--selected-account SELECTED_ACCOUNT]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences update-draft — Save edited content on a draft preview instance
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string; required | |
--draft-instance-id | string; required | |
--edited-content-json | json; input: json | Edited content JSON object |
--edited-content-file | file; input: file | Path to edited content JSON |
--data-json | json; input: json | Full {editedContent:{...}} payload JSON |
--data-file | file; input: file | Path to full draft update payload JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences update-draft [-h] --sequence-id SEQUENCE_ID
--draft-instance-id DRAFT_INSTANCE_ID
[--edited-content-json EDITED_CONTENT_JSON]
[--edited-content-file EDITED_CONTENT_FILE]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch sequences variable-catalog — Inspect legal sequence variables and source-table route candidates
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Returns executable lead/company/user/custom/research variables for sequence templates, plus candidate source_field_route fields when a source table is provided. Use this before writing SequenceIn templates or variableMap payloads.
| Argument | Contract | Description |
|---|---|---|
--sequence-id | string | Optional existing sequence id to inspect |
--source-table-id | string | Optional source table id for research variables and route suggestions |
--no-custom-fields | boolean; when omitted=false; when present=true | Exclude CRM custom fields |
--no-research-fields | boolean; when omitted=false; when present=true | Exclude source-table research fields |
--no-route-suggestions | boolean; when omitted=false; when present=true | Exclude route candidate sampling |
--route-sample-limit | integer; default: 100 | Rows to sample for route suggestions (1-250) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch sequences variable-catalog [-h] [--sequence-id SEQUENCE_ID]
[--source-table-id SOURCE_TABLE_ID]
[--no-custom-fields]
[--no-research-fields]
[--no-route-suggestions]
[--route-sample-limit ROUTE_SAMPLE_LIMIT]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]setup
autotouch setup — First-run setup with key validation
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--api-key | string; sensitive | Developer API key (stk_...) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--overwrite | boolean; when omitted=false; when present=true | Replace existing stored API key |
--use-x-api-key | boolean; when omitted=false; when present=true | Validate using X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "human" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
--no-banner | boolean; when omitted=false; when present=true | Skip banner in human mode |
Choose at most one of: --select, --json-pointer.
autotouch setup [-h] [--api-key API_KEY] [--base-url BASE_URL]
[--overwrite] [--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose] [--no-banner]signals
autotouch signals — Read Signals evidence and manage discovery monitors
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: query, catalog, discovery-industries, list-discovery-monitors, create-discovery-monitor, update-discovery-monitor, pause-discovery-monitor, resume-discovery-monitor.
autotouch signals [-h]
{query,catalog,discovery-industries,list-discovery-monitors,create-discovery-monitor,update-discovery-monitor,pause-discovery-monitor,resume-discovery-monitor}
...autotouch signals catalog — Read source criteria, cadences, taxonomy and billing policy
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Read the current Signals catalog. This configuration read starts no provider work. Developer keys require signals:read or legacy companies:read.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch signals catalog [-h] [--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch signals create-discovery-monitor — Create a discovery monitor
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Use the selected server's Signals catalog for criteria and billing. Create and enabled edits/resume can schedule paid collection; pause cancels owned queued/running work and preserves saved Signals plus checkpoints when criteria are unchanged. In-flight provider requests cannot be recalled. Updates require the exact monitor ID and current revision; conflicts are never automatically retried. Developer keys require signals:read, signals:write and signals:run, or all legacy companies:read, leads:read, companies:write and search:run.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Complete request JSON; flags can add fields absent from JSON |
--data-file | file; input: file | Complete request JSON file; use - for stdin |
--name | string | Monitor name, 1–120 characters |
--source | string; choices: jobs, linkedin_posts, job_changes, fda, sec_filings | Immutable source |
--run-now, --no-run-now | string | Request an initial check when enabled (server default true); --no-run-now waits for cadence |
--request-id | string | Stable create retry identity; reuse only with unchanged payload |
--criteria-json | json; input: json | Complete source criteria JSON; update replaces every criterion |
--frequency | string; choices: hourly, daily, weekly | Jobs: daily also searches the past day; weekly searches the past week. Other source cadences follow the selected server's Signals catalog. |
--enabled, --no-enabled | string | Enable paid scheduling or --no-enabled to pause/save paused |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch signals create-discovery-monitor --data-file monitor.jsonautotouch signals discovery-industries — Search canonical discovery industry choices
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Read up to twenty canonical industry choices without provider work. Use labels for Job changes and IDs for LinkedIn post author filters. Developer keys require signals:read or legacy companies:read.
| Argument | Contract | Description |
|---|---|---|
--q, --query | string; default: "" | Industry label or exact ID, up to 100 characters |
--limit | integer; default: 20 | Maximum choices, 1-20 (default: 20) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch signals discovery-industries [-h] [--q QUERY] [--limit LIMIT]
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch signals list-discovery-monitors — Read saved discovery monitors and collection status
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
List organization-owned discovery monitors, current revisions and collection status. This read starts no checks or provider work. Developer keys require signals:read, or both legacy companies:read and leads:read.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch signals list-discovery-monitors [-h] [--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch signals pause-discovery-monitor — Pause a discovery monitor
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Use the selected server's Signals catalog for criteria and billing. Create and enabled edits/resume can schedule paid collection; pause cancels owned queued/running work and preserves saved Signals plus checkpoints when criteria are unchanged. In-flight provider requests cannot be recalled. Updates require the exact monitor ID and current revision; conflicts are never automatically retried. Developer keys require signals:read, signals:write and signals:run, or all legacy companies:read, leads:read, companies:write and search:run.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Complete request JSON; flags can add fields absent from JSON |
--data-file | file; input: file | Complete request JSON file; use - for stdin |
--monitor-id | string | Exact saved monitor ID from list-discovery-monitors; required in flags or JSON |
--expected-revision | integer | Current saved revision; required in flags or JSON; no automatic reread |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch signals pause-discovery-monitor --monitor-id <MONITOR_ID> --expected-revision 3autotouch signals query — Search one page of saved Signals
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Search retained organization-visible signal events. This read makes no provider calls and does not enroll companies or run checks. Developer keys require signals:read, or both legacy companies:read and leads:read. The JSON response preserves items, has_more, next_cursor, limit, and as_of; pass next_cursor with the same filters to read another page.
| Argument | Contract | Description |
|---|---|---|
--entity | string; choices: all, companies, people; default: "all" | |
--feed-scope | string; choices: all, monitors, discover | Combined authorized feed (all), saved monitor matches, or remaining discovery observations; defaults to all |
--signal-type | string; repeatable; comma-separated | Signal family; repeatable or comma-separated |
--window-days | integer; choices: 0, 1, 7, 14, 30, 90; default: 7 | Event time window; 0 means all time (default: 7) |
--company-id | string | Exact organization Company id |
--monitor-id | string | Exact authorized monitor ID from list-discovery-monitors; reads its saved evidence, up to 200 characters |
--search, --q | string | Literal case-insensitive text search, up to 200 characters |
--content-category | string; choices: career_update, industry_commentary, company_announcement, funding, product_update, event, personal, other, unclassified | Social post category; unclassified includes posts without ready annotations |
--promotion | string; choices: yes, no, uncertain | Saved post promotion assessment, independent of category |
--job-ad | string; choices: all, yes, no, uncertain | Default hides job ads; all explicitly includes every post for review |
--topic | string | Exact lowercase snake_case social topic, up to 60 characters |
--reaction-count-min | integer | Inclusive min reaction count; missing counts do not match |
--reaction-count-max | integer | Inclusive max reaction count; missing counts do not match |
--comment-count-min | integer | Inclusive min comment count; missing counts do not match |
--comment-count-max | integer | Inclusive max comment count; missing counts do not match |
--share-count-min | integer | Inclusive min share count; missing counts do not match |
--share-count-max | integer | Inclusive max share count; missing counts do not match |
--sort-by | string; choices: newest, person_fit, signal_score, signal_type, reaction_count, comment_count, share_count | Server-side ordering across all matching signals |
--sort-direction | string; choices: asc, desc | Sort direction; unknown engagement stays last |
--limit | integer; default: 50 | Maximum events in this page, 1-100 (default: 50) |
--cursor | string | Opaque next_cursor from the preceding page; preserve all filters |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch signals query --search hiring --window-days 30 --limit 20
autotouch signals query --entity people --signal-type linkedin_posts --content-category industry_commentary --topic outbound_salesautotouch signals resume-discovery-monitor — Resume a discovery monitor
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Use the selected server's Signals catalog for criteria and billing. Create and enabled edits/resume can schedule paid collection; pause cancels owned queued/running work and preserves saved Signals plus checkpoints when criteria are unchanged. In-flight provider requests cannot be recalled. Updates require the exact monitor ID and current revision; conflicts are never automatically retried. Developer keys require signals:read, signals:write and signals:run, or all legacy companies:read, leads:read, companies:write and search:run.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Complete request JSON; flags can add fields absent from JSON |
--data-file | file; input: file | Complete request JSON file; use - for stdin |
--monitor-id | string | Exact saved monitor ID from list-discovery-monitors; required in flags or JSON |
--expected-revision | integer | Current saved revision; required in flags or JSON; no automatic reread |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch signals resume-discovery-monitor --monitor-id <MONITOR_ID> --expected-revision 3autotouch signals update-discovery-monitor — Update a discovery monitor
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Use the selected server's Signals catalog for criteria and billing. Create and enabled edits/resume can schedule paid collection; pause cancels owned queued/running work and preserves saved Signals plus checkpoints when criteria are unchanged. In-flight provider requests cannot be recalled. Updates require the exact monitor ID and current revision; conflicts are never automatically retried. Developer keys require signals:read, signals:write and signals:run, or all legacy companies:read, leads:read, companies:write and search:run.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Complete request JSON; flags can add fields absent from JSON |
--data-file | file; input: file | Complete request JSON file; use - for stdin |
--monitor-id | string | Exact saved monitor ID from list-discovery-monitors; required in flags or JSON |
--expected-revision | integer | Current saved revision; required in flags or JSON; no automatic reread |
--name | string | Monitor name, 1–120 characters |
--criteria-json | json; input: json | Complete source criteria JSON; update replaces every criterion |
--frequency | string; choices: hourly, daily, weekly | Jobs: daily also searches the past day; weekly searches the past week. Other source cadences follow the selected server's Signals catalog. |
--enabled, --no-enabled | string | Enable paid scheduling or --no-enabled to pause/save paused |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch signals update-discovery-monitor --monitor-id <MONITOR_ID> --expected-revision 3 --name 'New name'sop
autotouch sop — Print credit-safe execution SOP + default filtered run payload
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--out-file | file; input: file | Write SOP JSON to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch sop [-h] [--out-file OUT_FILE] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]status
autotouch status — Show pending/done/error counts for a table/column (requires pymongo + MONGODB_URI)
Auth: none. Stability: stable. Destructive: no.
Availability: optional_dependency.
Python modules: pymongo.
Environment variable names: MONGODB_URI.
Reads status directly from MongoDB instead of the HTTP API.
Requires pymongo at runtime and MONGODB_URI (or --mongo-uri).
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-id | string; required | |
--mongo-uri | string | Override MONGODB_URI |
--db-name | string | Override MONGODB_DB_NAME |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch status [-h] --table-id TABLE_ID --column-id COLUMN_ID
[--mongo-uri MONGO_URI] [--db-name DB_NAME]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]tables
autotouch tables — Table operations
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: enrich-and-score-preflight, enrich-and-score, enrich-and-score-retry, list, create, create-from-rows, update, field-meanings, set-field-meanings, identity, schema.
autotouch tables [-h]
{enrich-and-score-preflight,enrich-and-score,enrich-and-score-retry,list,create,create-from-rows,update,field-meanings,set-field-meanings,identity,schema}
...autotouch tables create — Create a table
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--name | string | Table name (when not using --data-json/--data-file) |
--metadata-json | json; input: json | Optional table metadata JSON object |
--metadata-file | file; input: file | Optional file with table metadata JSON |
--data-json | json; input: json | Explicit table create payload JSON |
--data-file | file; input: file | Path to table create payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tables create [-h] [--name NAME]
[--metadata-json METADATA_JSON]
[--metadata-file METADATA_FILE]
[--data-json DATA_JSON] [--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tables create-from-rows — Create a snapshot table from all, filtered, selected, or first-N source rows
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--source-table-id | string | Source Research Table id |
--source-table-name | string | Optional source table name for the receipt |
--table-name | string | Destination table name; inferred when omitted |
--scope | string; choices: filtered, all, subset, firstN; default: "filtered" | |
--filters-json | json; input: json | TableFilters JSON object for filtered scope |
--filters-file | file; input: file | Path to TableFilters JSON for filtered scope |
--row-id | string; repeatable | Source row id for subset scope; repeatable |
--first-n | integer | Number of rows for firstN scope |
--include-column | string; repeatable | Column key to include; repeatable |
--exclude-column | string; repeatable | Column key to exclude; repeatable |
--matched-count | integer | Expected exact source-row count |
--ingest-generation | string | Stable idempotency/checkpoint key |
--large-job-approval-json | json; input: json | Exact largeJobApproval JSON returned by a 409 preflight |
--large-job-approval-file | file; input: file | Path to exact largeJobApproval JSON |
--data-json | json; input: json | Full materialization plan JSON; overrides individual flags |
--data-file | file; input: file | Path to full materialization plan JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tables create-from-rows [-h]
[--source-table-id SOURCE_TABLE_ID]
[--source-table-name SOURCE_TABLE_NAME]
[--table-name TABLE_NAME]
[--scope {filtered,all,subset,firstN}]
[--filters-json FILTERS_JSON]
[--filters-file FILTERS_FILE]
[--row-id ROW_ID] [--first-n FIRST_N]
[--include-column INCLUDE_COLUMN]
[--exclude-column EXCLUDE_COLUMN]
[--matched-count MATCHED_COUNT]
[--ingest-generation INGEST_GENERATION]
[--large-job-approval-json LARGE_JOB_APPROVAL_JSON]
[--large-job-approval-file LARGE_JOB_APPROVAL_FILE]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tables enrich-and-score — Admit the exact reviewed Enrich & Score plan
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Admit the exact reviewed Enrich & Score plan
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--data-json | json; input: json | EnrichScoreExecuteRequest: preflight inputs plus returned planId, planVersion and a stable idempotencyKey as JSON |
--data-file | file; input: file | Path to EnrichScoreExecuteRequest: preflight inputs plus returned planId, planVersion and a stable idempotencyKey JSON (use - for stdin) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose exactly one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch tables enrich-and-score [-h] --table-id TABLE_ID
(--data-json DATA_JSON | --data-file DATA_FILE)
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tables enrich-and-score-preflight — Review the server-owned Enrich & Score plan without admitting a run
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Review the server-owned Enrich & Score plan without admitting a run
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--data-json | json; input: json | EnrichScorePreflightRequest: targetMode (accounts, people, accounts_people), scope {mode, rowIds}, mappings, options; optional fitColumnId as JSON |
--data-file | file; input: file | Path to EnrichScorePreflightRequest: targetMode (accounts, people, accounts_people), scope {mode, rowIds}, mappings, options; optional fitColumnId JSON (use - for stdin) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose exactly one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch tables enrich-and-score-preflight [-h] --table-id TABLE_ID
(--data-json DATA_JSON | --data-file DATA_FILE)
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tables enrich-and-score-retry — Retry unfinished rows from a terminal Enrich & Score parent
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Retry unfinished rows from a terminal Enrich & Score parent
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--operation-run-id | string; required | |
--data-json | json; input: json | EnrichScoreRetryRequest: optional idempotencyKey as JSON |
--data-file | file; input: file | Path to EnrichScoreRetryRequest: optional idempotencyKey JSON (use - for stdin) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --data-json, --data-file.
Choose at most one of: --select, --json-pointer.
autotouch tables enrich-and-score-retry [-h] --table-id TABLE_ID
--operation-run-id
OPERATION_RUN_ID
[--data-json DATA_JSON | --data-file DATA_FILE]
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tables field-meanings — Review detected fields and manual corrections
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tables field-meanings [-h] --table-id TABLE_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tables identity — Manage table ingest identity rules
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: get, set, clear.
autotouch tables identity [-h] {get,set,clear} ...autotouch tables identity clear — Remove all ingest_identity config from a table
Auth: developer_key_or_user_session. Stability: stable. Destructive: yes.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tables identity clear [-h] --table-id TABLE_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tables identity get — Print the current ingest_identity config for a table
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tables identity get [-h] --table-id TABLE_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tables identity set — Add or update an identity rule on a table
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-key | string; required | Column key to use as identity field |
--rule-id | string | Rule ID (defaults to --column-key) |
--match-strategy | string; required; choices: email, domain, linkedin_url, external_id, exact_text | Match normalisation strategy |
--source | string; choices: csv, webhook, list_builder, default; default: "default" | Ingest source this rule applies to (default: applies to all) |
--mode | string; choices: allow, skip, upsert; default: "upsert" | Duplicate handling mode: allow / skip / upsert (default: upsert) |
--merge-mode | string; choices: fill_empty, overwrite_mapped; default: "fill_empty" | Cell merge strategy when upserting (default: fill_empty) |
--disabled | boolean; when omitted=false; when present=true | Create rule as disabled |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tables identity set [-h] --table-id TABLE_ID --column-key
COLUMN_KEY [--rule-id RULE_ID]
--match-strategy
{email,domain,linkedin_url,external_id,exact_text}
[--source {csv,webhook,list_builder,default}]
[--mode {allow,skip,upsert}]
[--merge-mode {fill_empty,overwrite_mapped}]
[--disabled] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tables list — List tables
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--view-mode | string | Optional view mode filter |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tables list [-h] [--view-mode VIEW_MODE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tables schema — Print table payload schemas
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, create; default: "all" | |
--out-file | file; input: file | Write schema JSON to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch tables schema [-h] [--type {all,create}]
[--out-file OUT_FILE]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch tables set-field-meanings — Correct detected fields without running rows
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--data-json | json; input: json | Mapping version and exact field changes as JSON |
--data-file | file; input: file | Path to the field mappings JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tables set-field-meanings [-h] --table-id TABLE_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tables update — Update a table's name or metadata
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--metadata-json | json; input: json | Metadata JSON object to patch onto the table |
--metadata-file | file; input: file | Path to metadata JSON file |
--data-json | json; input: json | Full PATCH payload JSON (overrides --metadata-*) |
--data-file | file; input: file | Path to full PATCH payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tables update [-h] --table-id TABLE_ID
[--metadata-json METADATA_JSON]
[--metadata-file METADATA_FILE]
[--data-json DATA_JSON] [--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]tasks
autotouch tasks — Task queue operations
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: recipe, query, count, assignee-counts, get, stats, create, create-from-leads, update, delete, bulk-update, bulk-delete, draft, queue-with-content, schedule-email, prioritize-email, reschedule-email, schedule-linkedin, prioritize-linkedin, reschedule-linkedin.
autotouch tasks [-h]
{recipe,query,count,assignee-counts,get,stats,create,create-from-leads,update,delete,bulk-update,bulk-delete,draft,queue-with-content,schedule-email,email-schedule,prioritize-email,email-prioritize,reschedule-email,email-reschedule,schedule-linkedin,linkedin-schedule,prioritize-linkedin,linkedin-prioritize,reschedule-linkedin,linkedin-reschedule}
...autotouch tasks assignee-counts — Aggregate assignee counts for a TaskQueryRequest payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | TaskQueryRequest payload JSON |
--data-file | file; input: file | Path to TaskQueryRequest payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks assignee-counts [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks bulk-delete — Bulk delete tasks from a JSON payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | BulkTaskDeleteRequest payload JSON |
--data-file | file; input: file | Path to BulkTaskDeleteRequest payload JSON file |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks bulk-delete [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks bulk-update — Bulk update tasks from a JSON payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | BulkTaskUpdateRequest payload JSON |
--data-file | file; input: file | Path to BulkTaskUpdateRequest payload JSON file |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks bulk-update [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks count — Count tasks matching a TaskQueryRequest payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | TaskQueryRequest payload JSON |
--data-file | file; input: file | Path to TaskQueryRequest payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks count [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks create — Create tasks from a JSON payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | TaskQueueCreate payload JSON |
--data-file | file; input: file | Path to TaskQueueCreate payload JSON file |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks create [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks create-from-leads — Create ad-hoc tasks from lead IDs or a CRM lead selection
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | TaskCreateFromLeadsRequest payload JSON |
--data-file | file; input: file | Path to TaskCreateFromLeadsRequest payload JSON file |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks create-from-leads [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks delete — Delete one task (soft delete to skipped)
Auth: developer_key_or_user_session. Stability: stable. Destructive: yes.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks delete [-h] --task-id TASK_ID
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks draft — Generate an AI draft for one task
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--force | boolean; when omitted=false; when present=true | Force re-draft even if content already exists |
--data-json | json; input: json | Optional TaskDraftRequest payload JSON |
--data-file | file; input: file | Optional TaskDraftRequest payload JSON file |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks draft [-h] --task-id TASK_ID [--force]
[--data-json DATA_JSON] [--data-file DATA_FILE]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks get — Get one task by id
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks get [-h] --task-id TASK_ID [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks prioritize-email — Move an email task to the earliest legal send slot
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Aliases: email-prioritize.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks prioritize-email [-h] --task-id TASK_ID
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks prioritize-linkedin — Move a connected LinkedIn task to the earliest legal execution slot
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Aliases: linkedin-prioritize.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks prioritize-linkedin [-h] --task-id TASK_ID
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks query — Query tasks with a TaskQueryRequest payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | TaskQueryRequest payload JSON |
--data-file | file; input: file | Path to TaskQueryRequest payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks query [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks queue-with-content — Queue reviewed task content from a JSON payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--data-json | json; input: json | TaskQueueWithContentRequest payload JSON |
--data-file | file; input: file | Path to TaskQueueWithContentRequest payload JSON file |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks queue-with-content [-h] --task-id TASK_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks recipe — Print task payload recipes
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, query, query_linkedin, create, create_from_leads, create_linkedin, update, bulk_update, bulk_delete, draft, schedule_email, prioritize_email, reschedule_email, schedule_linkedin, prioritize_linkedin, reschedule_linkedin; default: "all" | |
--out-file | file; input: file | Optional path to save the selected payload JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks recipe [-h]
[--type {all,query,query_linkedin,create,create_from_leads,create_linkedin,update,bulk_update,bulk_delete,draft,schedule_email,prioritize_email,reschedule_email,schedule_linkedin,prioritize_linkedin,reschedule_linkedin}]
[--out-file OUT_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks reschedule-email — Move a scheduled email task to a requested send time
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Aliases: email-reschedule.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--data-json | json; input: json | TaskEmailRescheduleRequest payload JSON |
--data-file | file; input: file | Path to TaskEmailRescheduleRequest payload JSON file |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks reschedule-email [-h] --task-id TASK_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks reschedule-linkedin — Move a scheduled LinkedIn task to a requested execution time
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Aliases: linkedin-reschedule.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--data-json | json; input: json | LinkedInTaskRescheduleRequest payload JSON |
--data-file | file; input: file | Path to LinkedInTaskRescheduleRequest payload JSON file |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks reschedule-linkedin [-h] --task-id TASK_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks schedule-email — Schedule or send an email task from a JSON payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Aliases: email-schedule.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--data-json | json; input: json | TaskEmailScheduleRequest payload JSON |
--data-file | file; input: file | Path to TaskEmailScheduleRequest payload JSON file |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks schedule-email [-h] --task-id TASK_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks schedule-linkedin — Queue a connected LinkedIn task at a requested execution time
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Aliases: linkedin-schedule.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--data-json | json; input: json | Optional LinkedInTaskScheduleRequest payload JSON |
--data-file | file; input: file | Optional LinkedInTaskScheduleRequest payload JSON file |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks schedule-linkedin [-h] --task-id TASK_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks stats — Get task summary stats
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks stats [-h] [--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch tasks update — Update one task from a JSON payload
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--task-id | string; required | |
--data-json | json; input: json | TaskQueueUpdate payload JSON |
--data-file | file; input: file | Path to TaskQueueUpdate payload JSON file |
--actor-user-id | string | Optional actor override; must resolve to an active user in the same organization |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch tasks update [-h] --task-id TASK_ID [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--actor-user-id ACTOR_USER_ID]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]watch
autotouch watch — Watch status periodically (requires pymongo + MONGODB_URI)
Auth: none. Stability: stable. Destructive: no.
Availability: optional_dependency.
Python modules: pymongo.
Environment variable names: MONGODB_URI.
Streams status directly from MongoDB instead of the HTTP API.
Requires pymongo at runtime and MONGODB_URI (or --mongo-uri).
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--column-id | string; required | |
--interval | integer; default: 5 | |
--once | boolean; when omitted=false; when present=true | Fetch one snapshot and exit |
--mongo-uri | string | Override MONGODB_URI |
--db-name | string | Override MONGODB_DB_NAME |
--output | string; choices: json, ndjson, human; default: "human" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch watch [-h] --table-id TABLE_ID --column-id COLUMN_ID
[--interval INTERVAL] [--once] [--mongo-uri MONGO_URI]
[--db-name DB_NAME] [--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]webhooks
autotouch webhooks — Table webhook operations
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: recipe, get, rotate, ingest, configure-ingest, subscriptions, deliveries.
autotouch webhooks [-h]
{recipe,get,rotate,ingest,configure-ingest,subscriptions,deliveries}
...autotouch webhooks configure-ingest — Persist ingest identity settings on a table's webhook config
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--match-rule-id | string | Identity rule id or column key to match on |
--match-column | string | Column key to match on; alias for --match-rule-id when no rule id is set |
--match-strategy | string; choices: email, domain, linkedin_url, external_id, exact_text | Normalisation strategy for the match column |
--duplicate-mode | string; choices: allow, skip, upsert; default: "upsert" | Duplicate handling: allow / skip / upsert (default: upsert) |
--merge-mode | string; choices: fill_empty, overwrite_mapped; default: "fill_empty" | Cell merge strategy when upserting (default: fill_empty) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks configure-ingest [-h] --table-id TABLE_ID
[--match-rule-id MATCH_RULE_ID]
[--match-column MATCH_COLUMN]
[--match-strategy {email,domain,linkedin_url,external_id,exact_text}]
[--duplicate-mode {allow,skip,upsert}]
[--merge-mode {fill_empty,overwrite_mapped}]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks deliveries — Inspect webhook delivery outcomes
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, attempts.
autotouch webhooks deliveries [-h] {list,attempts} ...autotouch webhooks deliveries attempts — List delivery attempts for one delivery id
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--delivery-id | string; required | |
--limit | integer; default: 100 | Max attempts to return (1-500) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks deliveries attempts [-h] --delivery-id DELIVERY_ID
[--limit LIMIT]
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks deliveries list — List webhook deliveries
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--subscription-id | string | Filter by subscription id |
--status | string | Filter by status (queued/retry_scheduled/succeeded/failed) |
--event-type | string | Filter by event type |
--limit | integer; default: 100 | Max deliveries to return (1-500) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks deliveries list [-h]
[--subscription-id SUBSCRIPTION_ID]
[--status STATUS]
[--event-type EVENT_TYPE]
[--limit LIMIT]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks get — Get webhook config for a table
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks get [-h] --table-id TABLE_ID [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks ingest — Ingest records using table webhook token
Auth: webhook_token. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--webhook-token | string; sensitive | Table webhook token for CLI/header auth; no-header providers may use the ingest URL with ?token=<WEBHOOK_TOKEN> |
--records-json | json; input: json | Object, list, or {records:[...]} payload JSON |
--records-file | file; input: file | Path to JSON file containing records payload |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks ingest [-h] --table-id TABLE_ID
[--webhook-token WEBHOOK_TOKEN]
[--records-json RECORDS_JSON]
[--records-file RECORDS_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks recipe — Print webhook payload recipes
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, ingest, subscription_create, subscription_update, subscription_test; default: "all" | |
--out-file | file; input: file | Optional path to save the selected payload JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks recipe [-h]
[--type {all,ingest,subscription_create,subscription_update,subscription_test}]
[--out-file OUT_FILE] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks rotate — Create/rotate webhook token for a table
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--table-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks rotate [-h] --table-id TABLE_ID
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks subscriptions — Manage outbound webhook subscriptions
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, create, get, update, delete, pause, resume, rotate-secret, test.
autotouch webhooks subscriptions [-h]
{list,create,get,update,delete,pause,resume,rotate-secret,test}
...autotouch webhooks subscriptions create — Create a webhook subscription
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--url | string | Webhook endpoint URL |
--events | list | Event names or families (for example bulk_job.*) |
--paused | boolean; when omitted=false; when present=true | Create subscription as paused/disabled |
--filters-json | json; input: json | Optional filters JSON |
--filters-file | file; input: file | Optional filters JSON file |
--metadata-json | json; input: json | Optional metadata JSON |
--metadata-file | file; input: file | Optional metadata JSON file |
--retry-policy-json | json; input: json | Optional retryPolicy JSON |
--retry-policy-file | file; input: file | Optional retryPolicy JSON file |
--data-json | json; input: json | Full request payload JSON |
--data-file | file; input: file | Full request payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks subscriptions create [-h] [--url URL]
[--events [EVENTS ...]]
[--paused]
[--filters-json FILTERS_JSON]
[--filters-file FILTERS_FILE]
[--metadata-json METADATA_JSON]
[--metadata-file METADATA_FILE]
[--retry-policy-json RETRY_POLICY_JSON]
[--retry-policy-file RETRY_POLICY_FILE]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks subscriptions delete — Delete a webhook subscription
Auth: developer_key_or_user_session. Stability: stable. Destructive: yes.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--subscription-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks subscriptions delete [-h] --subscription-id
SUBSCRIPTION_ID
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks subscriptions get — Get a webhook subscription
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--subscription-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks subscriptions get [-h] --subscription-id
SUBSCRIPTION_ID
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks subscriptions list — List webhook subscriptions
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--include-disabled | boolean; when omitted=false; when present=true | Include paused/disabled subscriptions |
--limit | integer; default: 100 | Max subscriptions to return (1-500) |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks subscriptions list [-h] [--include-disabled]
[--limit LIMIT]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks subscriptions pause — Pause a webhook subscription
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--subscription-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks subscriptions pause [-h] --subscription-id
SUBSCRIPTION_ID
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks subscriptions resume — Resume a paused webhook subscription
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--subscription-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks subscriptions resume [-h] --subscription-id
SUBSCRIPTION_ID
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks subscriptions rotate-secret — Rotate webhook subscription signing secret
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--subscription-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks subscriptions rotate-secret [-h] --subscription-id
SUBSCRIPTION_ID
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks subscriptions test — Fire a test event for a subscription
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--subscription-id | string; required | |
--event-type | string | Optional event type (for example lead.created) |
--data-json | json; input: json | Optional test payload JSON |
--data-file | file; input: file | Optional test payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks subscriptions test [-h] --subscription-id
SUBSCRIPTION_ID
[--event-type EVENT_TYPE]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch webhooks subscriptions update — Update a webhook subscription
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--subscription-id | string; required | |
--data-json | json; input: json | Patch payload JSON |
--data-file | file; input: file | Patch payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch webhooks subscriptions update [-h] --subscription-id
SUBSCRIPTION_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]workflows
autotouch workflows — Goal-level workflow plans and scaffolds
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, plan, recipe, scaffold.
Use workflows for full user goals. Autotouch workflows follow Source Records -> Land In Smart Table -> Research And Operate -> Engage. Recipes are leaf templates; workflow plans describe the ordered path across list building, imports/webhooks, Smart Table research, Leads, Sequences, CRM, and outreach destinations.
autotouch workflows list
autotouch workflows plan --type bulk_outreach
autotouch workflows scaffold --type research_to_sequence --out-dir workflowautotouch workflows list — List canonical workflow plans grouped by lifecycle stage
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--out-file | file; input: file | Save JSON payload to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch workflows list [-h] [--out-file OUT_FILE]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch workflows plan — Emit one goal-level workflow plan
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Plan the workflow before creating files or running side effects. Use this to choose how records are sourced, landed in Smart Table, researched/operated on, and sent to the right engagement destination.
| Argument | Contract | Description |
|---|---|---|
--type | string; required; choices: bulk_outreach, company_rows_to_people_table, table_to_outreach, research_to_sequence, sequence_launch, table_to_routed_sequence, account_research, signal_outreach, website_visitors, list_build_to_table, company_discovery_to_contacts, external_api_to_table, system_to_table | Workflow plan id |
--out-file | file; input: file | Save raw workflow payload to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch workflows plan [-h] --type
{bulk_outreach,company_rows_to_people_table,table_to_outreach,research_to_sequence,sequence_launch,table_to_routed_sequence,account_research,signal_outreach,website_visitors,list_build_to_table,company_discovery_to_contacts,external_api_to_table,system_to_table}
[--out-file OUT_FILE]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch workflows recipe — Alias for `workflows plan`
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; required; choices: bulk_outreach, company_rows_to_people_table, table_to_outreach, research_to_sequence, sequence_launch, table_to_routed_sequence, account_research, signal_outreach, website_visitors, list_build_to_table, company_discovery_to_contacts, external_api_to_table, system_to_table | Workflow plan id |
--out-file | file; input: file | Save raw workflow payload to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch workflows recipe [-h] --type
{bulk_outreach,company_rows_to_people_table,table_to_outreach,research_to_sequence,sequence_launch,table_to_routed_sequence,account_research,signal_outreach,website_visitors,list_build_to_table,company_discovery_to_contacts,external_api_to_table,system_to_table}
[--out-file OUT_FILE]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch workflows scaffold — Emit ordered workflow files and commands for a workflow plan
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; required; choices: bulk_outreach, company_rows_to_people_table, table_to_outreach, research_to_sequence, sequence_launch, table_to_routed_sequence, account_research, signal_outreach, website_visitors, list_build_to_table, company_discovery_to_contacts, external_api_to_table, system_to_table | Workflow plan id |
--out-dir | string | Directory to save scaffold payload files |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch workflows scaffold [-h] --type
{bulk_outreach,company_rows_to_people_table,table_to_outreach,research_to_sequence,sequence_launch,table_to_routed_sequence,account_research,signal_outreach,website_visitors,list_build_to_table,company_discovery_to_contacts,external_api_to_table,system_to_table}
[--out-dir OUT_DIR]
[--output {json,ndjson,human}] [--compact]
[--select SELECT | --json-pointer JSON_POINTER]workspace-secrets
autotouch workspace-secrets — Manage reusable org-scoped secrets for HTTP request columns
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, set, delete, schema.
Manage reusable org-scoped secrets used by {{secrets.name}} templates in HTTP request columns and other templated features.
Developer API keys need secrets:read / secrets:write scopes (or *) for these endpoints.
Workspace secrets are optional; HTTP request columns can still use literal headers/body values.autotouch workspace-secrets set --name clearbit --value "$CLEARBIT_API_KEY"
autotouch workspace-secrets list
autotouch workspace-secrets delete --name clearbit --yesautotouch workspace-secrets delete — Delete a workspace secret
Auth: developer_key_or_user_session. Stability: stable. Destructive: yes.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--name | string; required | Secret/provider slug to delete |
--yes | boolean; when omitted=false; when present=true | Confirm deletion |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch workspace-secrets delete [-h] --name NAME [--yes]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch workspace-secrets list — List workspace secrets (masked values)
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch workspace-secrets list [-h] [--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch workspace-secrets schema — Print workspace-secrets payload schemas
Auth: none. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--type | string; choices: all, set; default: "all" | |
--out-file | file; input: file | Write schema JSON to file |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
Choose at most one of: --select, --json-pointer.
autotouch workspace-secrets schema [-h] [--type {all,set}]
[--out-file OUT_FILE]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]autotouch workspace-secrets set — Create or update a workspace secret
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
Create or update a workspace secret used by {{secrets.name}} template references.
| Argument | Contract | Description |
|---|---|---|
--name | string | Secret/provider slug, for example clearbit |
--value | string; sensitive | Secret value (for example an API key or bearer token) |
--data-json | json; input: json | Explicit workspace secret payload JSON |
--data-file | file; input: file | Path to workspace secret payload JSON file |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch workspace-secrets set [-h] [--name NAME] [--value VALUE]
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]workspace-views
autotouch workspace-views — Manage saved Leads and Companies views
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: list, create, update, set-default, delete.
autotouch workspace-views list --workspace leads
autotouch workspace-views create --data-file saved-view.json
autotouch workspace-views set-default --view-id <VIEW_ID>
autotouch workspace-views delete --view-id <VIEW_ID> --yesautotouch workspace-views create — Create a saved workspace view
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--data-json | json; input: json | Workspace view payload JSON |
--data-file | file; input: file | Path to workspace view payload JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch workspace-views create [-h] [--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch workspace-views delete — Delete a saved workspace view
Auth: developer_key_or_user_session. Stability: stable. Destructive: yes.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--view-id | string; required | |
--yes | boolean; when omitted=false; when present=true | Required confirmation for delete |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch workspace-views delete [-h] --view-id VIEW_ID [--yes]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch workspace-views list — List saved views for one workspace
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--workspace | string; required; choices: leads, companies, tasks | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch workspace-views list [-h] --workspace {leads,companies,tasks}
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch workspace-views set-default — Set the user's default saved view
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--view-id | string; required | |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch workspace-views set-default [-h] --view-id VIEW_ID
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch workspace-views update — Update a saved workspace view
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--view-id | string; required | |
--data-json | json; input: json | Partial workspace view payload JSON |
--data-file | file; input: file | Path to partial workspace view payload JSON |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch workspace-views update [-h] --view-id VIEW_ID
[--data-json DATA_JSON]
[--data-file DATA_FILE]
[--base-url BASE_URL] [--token TOKEN]
[--use-x-api-key] [--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]workspaces
autotouch workspaces — Read workspace column and selection catalogs
Auth: varies_by_subcommand. Stability: stable. Destructive: no.
Subcommands: column-catalog, selection-catalog.
autotouch workspaces column-catalog --workspace leads
autotouch workspaces selection-catalog --workspace companiesautotouch workspaces column-catalog — Read workspace table-column picker fields
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--workspace | string; required; choices: leads, companies, tasks | |
--source-table-id | string | Optional research source table id for source-scoped fields |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch workspaces column-catalog [-h] --workspace
{leads,companies,tasks}
[--source-table-id SOURCE_TABLE_ID]
[--base-url BASE_URL]
[--token TOKEN] [--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]autotouch workspaces selection-catalog — Read executable workspace filter fields
Auth: developer_key_or_user_session. Stability: stable. Destructive: no.
Output modes: json, ndjson, human.
| Argument | Contract | Description |
|---|---|---|
--workspace | string; required; choices: leads, companies, tasks | |
--source-table-id | string | Optional research source table id for source-scoped fields |
--base-url | string; default: "https://app.autotouch.ai" | API base URL (default: https://app.autotouch.ai) |
--token | string; sensitive | Developer API key / JWT token |
--use-x-api-key | boolean; when omitted=false; when present=true | Send token via X-API-Key header |
--timeout | integer; default: 30 | HTTP timeout in seconds |
--output | string; choices: json, ndjson, human; default: "json" | Output mode |
--compact | boolean; when omitted=false; when present=true | Print compact JSON |
--select | string | Extract a dotted field path from the final result (for example: id or items.0.id) |
--json-pointer | string | Extract a JSON pointer from the final result (for example: /id) |
--verbose | boolean; when omitted=false; when present=true | Print request metadata to stderr |
Choose at most one of: --select, --json-pointer.
autotouch workspaces selection-catalog [-h] --workspace
{leads,companies,tasks}
[--source-table-id SOURCE_TABLE_ID]
[--base-url BASE_URL]
[--token TOKEN]
[--use-x-api-key]
[--timeout TIMEOUT]
[--output {json,ndjson,human}]
[--compact]
[--select SELECT | --json-pointer JSON_POINTER]
[--verbose]