update_system_prompt
Replace the value of an existing workspace prompt template (or shadow a global default by creating the org-scoped row for the first time). Use when the user iterates: 'tighten this prompt', 'rewrite our show_notes template', 'drop the last paragraph'. Confirm the new value with the user before saving — every subsequent generation job will pick it up. Rejects if the key has no existing row (org or global); use create_system_prompt for genuinely new keys. Some keys are RESERVED and cannot be overridden — the agent's integrity-level rules (anti-fabrication; see RULES with overridable: false in src/lib/agents/runtime/rules.ts). Attempting to update those returns INVALID_INPUT.
Request
- Base URL: https://app.podmule.com/api/v1
- URL: https://app.podmule.com/api/v1/update_system_prompt
- Auth: HTTP bearer
Headers
Stripe-style idempotency key. When present, repeat invocations within 24h with the same body return the original response; same key + different body returns 409 IDEMPOTENCY_KEY_REUSED.
When set to "true", routes the call to the capability's dryRun() method — same scope/precondition checks fire as the real handler, but persistence is skipped. The audit row is tagged result_status=dry_run.
Request body
Response
Capability output wrapped in { data }.
Changes
No recorded changes to this operation across all 1 revision of this API.