autotouch-cli 0.2.42__tar.gz → 0.2.44__tar.gz

{autotouch_cli-0.2.42 → autotouch_cli-0.2.44}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.42
+Version: 0.2.44
 Summary: Autotouch Smart Table CLI
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -137,7 +137,7 @@ Use a dedicated `AUTOTOUCH_CONFIG_PATH` if you want a clean local account instea
 
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.42/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.42/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.42/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.42/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.44/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.44/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.44/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.44/docs/platform/authentication.md

{autotouch_cli-0.2.42 → autotouch_cli-0.2.44}/README.md

@@ -128,7 +128,7 @@ Use a dedicated `AUTOTOUCH_CONFIG_PATH` if you want a clean local account instea
 
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.42/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.42/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.42/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.42/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.44/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.44/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.44/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.44/docs/platform/authentication.md

{autotouch_cli-0.2.42 → autotouch_cli-0.2.44}/autotouch_cli/cli.py

@@ -186,6 +186,15 @@ from autotouch_cli.commands.webhooks import (
     cmd_webhooks_subscriptions_test as cmd_webhooks_subscriptions_test_impl,
     cmd_webhooks_subscriptions_update as cmd_webhooks_subscriptions_update_impl,
 )
+from autotouch_cli.commands.prompts import (
+    PromptCommandRuntime as PromptCommandHandlerRuntime,
+    cmd_prompts_create as cmd_prompts_create_impl,
+    cmd_prompts_delete as cmd_prompts_delete_impl,
+    cmd_prompts_get as cmd_prompts_get_impl,
+    cmd_prompts_list as cmd_prompts_list_impl,
+    cmd_prompts_update as cmd_prompts_update_impl,
+    register_prompts_subcommands,
+)
 from autotouch_cli.commands.workspace_secrets import (
     WorkspaceSecretCommandRuntime as WorkspaceSecretCommandHandlerRuntime,
     cmd_workspace_secrets_delete as cmd_workspace_secrets_delete_impl,
@@ -271,6 +280,7 @@ from autotouch_cli.templates import (
     ONBOARDING_SCHEMA_TYPES,
     ORG_CONTEXT_SCHEMA_TYPES,
     PERSONAL_CONTEXT_SCHEMA_TYPES,
+    PROMPT_TEMPLATE_SCHEMA_TYPES,
     WORKSPACE_SECRET_SCHEMA_TYPES,
     ROW_SCHEMA_TYPES,
     SEQUENCE_RECIPE_TYPES,
@@ -288,6 +298,7 @@ from autotouch_cli.templates import (
     emit_onboarding_schema,
     emit_org_context_schema,
     emit_personal_context_schema,
+    emit_prompt_templates_schema,
     emit_workspace_secrets_schema,
     emit_rows_schema,
     emit_schema,
@@ -2262,6 +2273,26 @@ def cmd_auth_clear(args: argparse.Namespace) -> None:
     cmd_auth_clear_impl(args, runtime=_auth_command_runtime())
 
 
+def cmd_prompts_list(args: argparse.Namespace) -> None:
+    cmd_prompts_list_impl(args, runtime=_prompt_command_runtime())
+
+
+def cmd_prompts_get(args: argparse.Namespace) -> None:
+    cmd_prompts_get_impl(args, runtime=_prompt_command_runtime())
+
+
+def cmd_prompts_create(args: argparse.Namespace) -> None:
+    cmd_prompts_create_impl(args, runtime=_prompt_command_runtime())
+
+
+def cmd_prompts_update(args: argparse.Namespace) -> None:
+    cmd_prompts_update_impl(args, runtime=_prompt_command_runtime())
+
+
+def cmd_prompts_delete(args: argparse.Namespace) -> None:
+    cmd_prompts_delete_impl(args, runtime=_prompt_command_runtime())
+
+
 def cmd_workspace_secrets_list(args: argparse.Namespace) -> None:
     cmd_workspace_secrets_list_impl(args, runtime=_workspace_secret_command_runtime())
 
@@ -2648,6 +2679,10 @@ def cmd_personal_context_schema(args: argparse.Namespace) -> None:
     emit_personal_context_schema(args, _template_runtime())
 
 
+def cmd_prompts_schema(args: argparse.Namespace) -> None:
+    emit_prompt_templates_schema(args, _template_runtime())
+
+
 def cmd_workspace_secrets_schema(args: argparse.Namespace) -> None:
     emit_workspace_secrets_schema(args, _template_runtime())
 
@@ -2800,6 +2835,15 @@ def _auth_command_runtime() -> AuthCommandHandlerRuntime:
     )
 
 
+def _prompt_command_runtime() -> PromptCommandHandlerRuntime:
+    return PromptCommandHandlerRuntime(
+        resolve_token=_resolve_token,
+        request_api=_request_api,
+        print_json=lambda data, compact=False: _print_json(data, compact=compact),
+        load_json_input=_load_json_input,
+    )
+
+
 def _workspace_secret_command_runtime() -> WorkspaceSecretCommandHandlerRuntime:
     return WorkspaceSecretCommandHandlerRuntime(
         resolve_token=_resolve_token,
@@ -3847,6 +3891,21 @@ def build_parser() -> argparse.ArgumentParser:
         workspace_secret_schema_types=WORKSPACE_SECRET_SCHEMA_TYPES,
     )
 
+    register_prompts_subcommands(
+        sub,
+        add_api_common_arguments=_add_api_common_arguments,
+        add_output_formatting_arguments=_add_output_formatting_arguments,
+        handlers={
+            "list": cmd_prompts_list,
+            "get": cmd_prompts_get,
+            "create": cmd_prompts_create,
+            "update": cmd_prompts_update,
+            "delete": cmd_prompts_delete,
+            "schema": cmd_prompts_schema,
+        },
+        prompt_template_schema_types=PROMPT_TEMPLATE_SCHEMA_TYPES,
+    )
+
     # resolved context
     pctx = sub.add_parser("context", help="Resolved requester context used by enrichment/runtime")
     ctx_sub = pctx.add_subparsers(dest="context_cmd", required=True)

autotouch_cli-0.2.44/autotouch_cli/commands/prompts.py

@@ -0,0 +1,240 @@
+from __future__ import annotations
+
+import argparse
+import sys
+from dataclasses import dataclass
+from typing import Any, Callable, Dict, Optional, Sequence
+
+
+@dataclass(frozen=True)
+class PromptCommandRuntime:
+    resolve_token: Callable[[Optional[str], bool], Optional[str]]
+    request_api: Callable[..., Any]
+    print_json: Callable[[Any, bool], None]
+    load_json_input: Callable[..., Any]
+
+
+def cmd_prompts_list(
+    args: argparse.Namespace,
+    *,
+    runtime: PromptCommandRuntime,
+) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    params: Dict[str, str] = {}
+    mode = getattr(args, "mode", None)
+    if mode:
+        params["mode"] = mode
+    data = runtime.request_api(
+        "GET",
+        "/api/enrichments/prompt-templates",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout,
+        verbose=args.verbose,
+        params=params,
+    )
+    runtime.print_json(data, args.compact)
+
+
+def cmd_prompts_get(
+    args: argparse.Namespace,
+    *,
+    runtime: PromptCommandRuntime,
+) -> None:
+    template_id = str(getattr(args, "id", "") or "").strip()
+    if not template_id:
+        print("ERROR: --id is required", file=sys.stderr)
+        sys.exit(2)
+
+    token = runtime.resolve_token(args.token, required=True)
+    # List all and filter client-side (no dedicated GET-by-id endpoint)
+    data = runtime.request_api(
+        "GET",
+        "/api/enrichments/prompt-templates",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    if isinstance(data, list):
+        match = next((t for t in data if t.get("id") == template_id), None)
+        if not match:
+            print(f"ERROR: prompt template not found: {template_id}", file=sys.stderr)
+            sys.exit(1)
+        runtime.print_json(match, args.compact)
+    else:
+        runtime.print_json(data, args.compact)
+
+
+def cmd_prompts_create(
+    args: argparse.Namespace,
+    *,
+    runtime: PromptCommandRuntime,
+) -> None:
+    token = runtime.resolve_token(args.token, required=True)
+    payload = runtime.load_json_input(
+        inline_json=getattr(args, "data_json", None),
+        file_path=getattr(args, "data_file", None),
+        context="data",
+        default=None,
+    )
+    if not payload or not isinstance(payload, dict):
+        print("ERROR: prompts create requires a JSON payload via --data-json or --data-file", file=sys.stderr)
+        sys.exit(2)
+
+    data = runtime.request_api(
+        "POST",
+        "/api/enrichments/prompt-templates",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=payload,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
+def cmd_prompts_update(
+    args: argparse.Namespace,
+    *,
+    runtime: PromptCommandRuntime,
+) -> None:
+    template_id = str(getattr(args, "id", "") or "").strip()
+    if not template_id:
+        print("ERROR: --id is required", file=sys.stderr)
+        sys.exit(2)
+
+    token = runtime.resolve_token(args.token, required=True)
+    payload = runtime.load_json_input(
+        inline_json=getattr(args, "data_json", None),
+        file_path=getattr(args, "data_file", None),
+        context="data",
+        default=None,
+    )
+    if not payload or not isinstance(payload, dict):
+        print("ERROR: prompts update requires a JSON payload via --data-json or --data-file", file=sys.stderr)
+        sys.exit(2)
+
+    data = runtime.request_api(
+        "PATCH",
+        f"/api/enrichments/prompt-templates/{template_id}",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=payload,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
+def cmd_prompts_delete(
+    args: argparse.Namespace,
+    *,
+    runtime: PromptCommandRuntime,
+) -> None:
+    if not getattr(args, "yes", False):
+        print(
+            "ERROR: prompt template delete is destructive. Re-run with --yes to confirm.",
+            file=sys.stderr,
+        )
+        sys.exit(2)
+
+    template_id = str(getattr(args, "id", "") or "").strip()
+    if not template_id:
+        print("ERROR: --id is required", file=sys.stderr)
+        sys.exit(2)
+
+    token = runtime.resolve_token(args.token, required=True)
+    data = runtime.request_api(
+        "DELETE",
+        f"/api/enrichments/prompt-templates/{template_id}",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    runtime.print_json(data, args.compact)
+
+
+def register_prompts_subcommands(
+    subparsers: argparse._SubParsersAction[argparse.ArgumentParser],
+    *,
+    add_api_common_arguments: Callable[[argparse.ArgumentParser], None],
+    add_output_formatting_arguments: Callable[[argparse.ArgumentParser], None],
+    handlers: Dict[str, Callable[[argparse.Namespace], None]],
+    prompt_template_schema_types: Sequence[str],
+) -> None:
+    pp = subparsers.add_parser(
+        "prompts",
+        help="Manage saved prompt templates for LLM enrichment columns",
+        description=(
+            "List, create, update, and delete prompt templates used by LLM enrichment columns. "
+            "Templates can be scoped to a single user (private) or shared with the team."
+        ),
+        epilog=(
+            "Developer API keys need prompts:read / prompts:write scopes (or *) for these endpoints."
+        ),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    pp._codex_examples = [
+        '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> --yes',
+    ]
+    pp_sub = pp.add_subparsers(dest="prompts_cmd", required=True)
+
+    # list
+    ppl = pp_sub.add_parser("list", help="List prompt templates")
+    ppl.add_argument("--mode", choices=["basic", "agent"], help="Filter by mode")
+    add_api_common_arguments(ppl)
+    ppl.set_defaults(func=handlers["list"])
+
+    # get
+    ppg = pp_sub.add_parser("get", help="Get a single prompt template by ID")
+    ppg.add_argument("--id", required=True, help="Prompt template ID")
+    add_api_common_arguments(ppg)
+    ppg.set_defaults(func=handlers["get"])
+
+    # create
+    ppc = pp_sub.add_parser(
+        "create",
+        help="Create a new prompt template",
+        description="Create a new prompt template. Requires a JSON payload with name, content, type, and mode.",
+    )
+    ppc.add_argument("--data-json", help="Inline JSON payload")
+    ppc.add_argument("--data-file", help="Path to JSON payload file")
+    add_api_common_arguments(ppc)
+    ppc.set_defaults(func=handlers["create"])
+
+    # update
+    ppu = pp_sub.add_parser(
+        "update",
+        help="Update an existing prompt template",
+        description="Partially update a prompt template. Only include the fields you want to change.",
+    )
+    ppu.add_argument("--id", required=True, help="Prompt template ID")
+    ppu.add_argument("--data-json", help="Inline JSON payload")
+    ppu.add_argument("--data-file", help="Path to JSON payload file")
+    add_api_common_arguments(ppu)
+    ppu.set_defaults(func=handlers["update"])
+
+    # delete
+    ppd = pp_sub.add_parser("delete", help="Delete a prompt template")
+    ppd.add_argument("--id", required=True, help="Prompt template ID")
+    ppd.add_argument("--yes", action="store_true", help="Confirm deletion")
+    add_api_common_arguments(ppd)
+    ppd.set_defaults(func=handlers["delete"])
+
+    # schema
+    pps = pp_sub.add_parser("schema", help="Print prompt template payload schemas")
+    pps.add_argument("--type", choices=["all", *prompt_template_schema_types], default="all")
+    pps.add_argument("--out-file", help="Write schema JSON to file")
+    add_output_formatting_arguments(pps)
+    pps.set_defaults(func=handlers["schema"])

{autotouch_cli-0.2.42 → autotouch_cli-0.2.44}/autotouch_cli/data/CLI_REFERENCE.md

@@ -1,6 +1,6 @@
 # Autotouch CLI Reference
 
-Generated from the installed parser for `autotouch-cli` `0.2.42`.
+Generated from the installed parser for `autotouch-cli` `0.2.44`.
 
 ## Output Modes
 
@@ -2289,6 +2289,200 @@ Save personal context
   - `--json-pointer`: Extract a JSON pointer from the final result (for example: /id)
   - `--verbose` (default=False): Print request metadata to stderr
 
+### `prompts`
+
+#### `autotouch prompts`
+
+Manage saved prompt templates for LLM enrichment columns
+
+List, create, update, and delete prompt templates used by LLM enrichment columns. Templates can be scoped to a single user (private) or shared with the team.
+
+- Auth: `varies_by_subcommand`
+- Stability: `stable`
+- Destructive: `no`
+- Subcommands: `list, get, create, update, delete, schema`
+- Example:
+  - `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> --yes`
+- Notes:
+
+```text
+Developer API keys need prompts:read / prompts:write scopes (or *) for these endpoints.
+```
+
+#### `autotouch prompts create`
+
+Create a new prompt template
+
+Create a new prompt template. Requires a JSON payload with name, content, type, and mode.
+
+- Auth: `developer_key_or_user_session`
+- Stability: `stable`
+- Destructive: `no`
+- Output modes: `json, ndjson, human`
+- Example:
+  - `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]`
+- Options:
+  - `--data-json`: Inline JSON payload
+  - `--data-file`: Path to JSON payload file
+  - `--base-url` (default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
+  - `--token`: Developer API key / JWT token
+  - `--use-x-api-key` (default=False): Send token via X-API-Key header
+  - `--timeout` (default=30): HTTP timeout in seconds
+  - `--output` (choices=json,ndjson,human; default=json): Output mode
+  - `--compact` (default=False): Print compact JSON
+  - `--select`: Extract a dotted field path from the final result (for example: id or items.0.id)
+  - `--json-pointer`: Extract a JSON pointer from the final result (for example: /id)
+  - `--verbose` (default=False): Print request metadata to stderr
+
+#### `autotouch prompts delete`
+
+Delete a prompt template
+
+- Auth: `developer_key_or_user_session`
+- Stability: `stable`
+- Destructive: `yes`
+- Required flags: `--id`
+- Output modes: `json, ndjson, human`
+- Example:
+  - `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]`
+- Options:
+  - `--id` (required): Prompt template ID
+  - `--yes` (default=False): Confirm deletion
+  - `--base-url` (default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
+  - `--token`: Developer API key / JWT token
+  - `--use-x-api-key` (default=False): Send token via X-API-Key header
+  - `--timeout` (default=30): HTTP timeout in seconds
+  - `--output` (choices=json,ndjson,human; default=json): Output mode
+  - `--compact` (default=False): Print compact JSON
+  - `--select`: Extract a dotted field path from the final result (for example: id or items.0.id)
+  - `--json-pointer`: Extract a JSON pointer from the final result (for example: /id)
+  - `--verbose` (default=False): Print request metadata to stderr
+
+#### `autotouch prompts get`
+
+Get a single prompt template by ID
+
+- Auth: `developer_key_or_user_session`
+- Stability: `stable`
+- Destructive: `no`
+- Required flags: `--id`
+- Output modes: `json, ndjson, human`
+- Example:
+  - `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]`
+- Options:
+  - `--id` (required): Prompt template ID
+  - `--base-url` (default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
+  - `--token`: Developer API key / JWT token
+  - `--use-x-api-key` (default=False): Send token via X-API-Key header
+  - `--timeout` (default=30): HTTP timeout in seconds
+  - `--output` (choices=json,ndjson,human; default=json): Output mode
+  - `--compact` (default=False): Print compact JSON
+  - `--select`: Extract a dotted field path from the final result (for example: id or items.0.id)
+  - `--json-pointer`: Extract a JSON pointer from the final result (for example: /id)
+  - `--verbose` (default=False): Print request metadata to stderr
+
+#### `autotouch prompts list`
+
+List prompt templates
+
+- Auth: `developer_key_or_user_session`
+- Stability: `stable`
+- Destructive: `no`
+- Output modes: `json, ndjson, human`
+- Example:
+  - `autotouch prompts list [-h] [--mode {basic,agent}]
+                              [--base-url BASE_URL] [--token TOKEN]
+                              [--use-x-api-key] [--timeout TIMEOUT]
+                              [--output {json,ndjson,human}] [--compact]
+                              [--select SELECT | --json-pointer JSON_POINTER]
+                              [--verbose]`
+- Options:
+  - `--mode` (choices=basic,agent): Filter by mode
+  - `--base-url` (default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
+  - `--token`: Developer API key / JWT token
+  - `--use-x-api-key` (default=False): Send token via X-API-Key header
+  - `--timeout` (default=30): HTTP timeout in seconds
+  - `--output` (choices=json,ndjson,human; default=json): Output mode
+  - `--compact` (default=False): Print compact JSON
+  - `--select`: Extract a dotted field path from the final result (for example: id or items.0.id)
+  - `--json-pointer`: Extract a JSON pointer from the final result (for example: /id)
+  - `--verbose` (default=False): Print request metadata to stderr
+
+#### `autotouch prompts schema`
+
+Print prompt template payload schemas
+
+- Auth: `none`
+- Stability: `stable`
+- Destructive: `no`
+- Output modes: `json, ndjson, human`
+- Example:
+  - `autotouch prompts schema [-h] [--type {all,create,update}]
+                                [--out-file OUT_FILE]
+                                [--output {json,ndjson,human}] [--compact]
+                                [--select SELECT |
+                                --json-pointer JSON_POINTER]`
+- Options:
+  - `--type` (choices=all,create,update; default=all)
+  - `--out-file`: Write schema JSON to file
+  - `--output` (choices=json,ndjson,human; default=json): Output mode
+  - `--compact` (default=False): Print compact JSON
+  - `--select`: Extract a dotted field path from the final result (for example: id or items.0.id)
+  - `--json-pointer`: Extract a JSON pointer from the final result (for example: /id)
+
+#### `autotouch prompts update`
+
+Update an existing prompt template
+
+Partially update a prompt template. Only include the fields you want to change.
+
+- Auth: `developer_key_or_user_session`
+- Stability: `stable`
+- Destructive: `no`
+- Required flags: `--id`
+- Output modes: `json, ndjson, human`
+- Example:
+  - `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]`
+- Options:
+  - `--id` (required): Prompt template ID
+  - `--data-json`: Inline JSON payload
+  - `--data-file`: Path to JSON payload file
+  - `--base-url` (default=https://app.autotouch.ai): API base URL (default: https://app.autotouch.ai)
+  - `--token`: Developer API key / JWT token
+  - `--use-x-api-key` (default=False): Send token via X-API-Key header
+  - `--timeout` (default=30): HTTP timeout in seconds
+  - `--output` (choices=json,ndjson,human; default=json): Output mode
+  - `--compact` (default=False): Print compact JSON
+  - `--select`: Extract a dotted field path from the final result (for example: id or items.0.id)
+  - `--json-pointer`: Extract a JSON pointer from the final result (for example: /id)
+  - `--verbose` (default=False): Print request metadata to stderr
+
 ### `rows`
 
 #### `autotouch rows`