{"openapi":"3.1.0","info":{"title":"Kano API","version":"0.1.0"},"servers":[{"url":"https://app.kano.pm"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}],"paths":{"/api/ops/list_types":{"post":{"operationId":"list_types","summary":"List artifact types","description":"List registered artifact types with ID prefix, statuses, allowed link keys and body sections.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/get_schema":{"post":{"operationId":"get_schema","summary":"Get type schema","description":"JSON Schema of an artifact type's frontmatter.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"type":{"type":"string"}},"required":["type"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/list_artifacts":{"post":{"operationId":"list_artifacts","summary":"List artifacts","description":"List artifacts from the index, filtered by type, status and any frontmatter field (where: {\"links.goals\": \"G-002\", horizon: \"now\"}).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"type":{"type":"string"},"status":{"type":"string"},"where":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"fields":{"description":"Extra frontmatter fields to include","type":"array","items":{"type":"string"}},"limit":{"default":200,"type":"integer","exclusiveMinimum":0,"maximum":1000}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/get_artifact":{"post":{"operationId":"get_artifact","summary":"Get artifact","description":"Read one artifact: frontmatter, body, derived fields, diagnostics and back-links.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"include_body":{"default":true,"type":"boolean"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/search_artifacts":{"post":{"operationId":"search_artifacts","summary":"Search","description":"Search the workspace. auto (default) fuses full-text and semantic results when embeddings are configured (FR-8.15); keyword is exact terms only; semantic matches meaning. Returns ranked hits with snippets.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string","minLength":1},"type":{"type":"string"},"limit":{"default":20,"type":"integer","exclusiveMinimum":0,"maximum":100},"mode":{"default":"auto","type":"string","enum":["auto","keyword","semantic"]}},"required":["query"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/find_similar":{"post":{"operationId":"find_similar","summary":"Find similar","description":"Artifacts semantically close to one artifact (cosine similarity 0–1), e.g. near-duplicate feedback (FR-7.5) or related opportunities. Needs embeddings (search.embeddings).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"type":{"type":"string"},"threshold":{"default":0.8,"type":"number","minimum":0,"maximum":1},"limit":{"default":10,"type":"integer","exclusiveMinimum":0,"maximum":50}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/suggest_links":{"post":{"operationId":"suggest_links","summary":"Suggest links","description":"ADR 0017: typed links an artifact is probably missing (both directions: links it should hold and links other artifacts should hold to it) and possible duplicates, from [[ID]] mentions, entity names, keywords and, with embeddings on, semantic neighbours. Read-only; apply with link_artifacts.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"semantic":{"default":true,"description":"Use embeddings when configured","type":"boolean"},"limit":{"default":10,"type":"integer","exclusiveMinimum":0,"maximum":30}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/create_artifact":{"post":{"operationId":"create_artifact","summary":"Create artifact","description":"Create an artifact with the next free ID and the type's template. Never invent IDs. Agent writes to review-policy paths become proposals on a review branch. The result may carry `suggestions`: typed links to existing artifacts and possible duplicates (ADR 0017) — apply the right ones with link_artifacts.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"type":{"type":"string"},"title":{"type":"string","minLength":1},"fields":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Frontmatter fields; dotted keys allowed (rice.reach); null removes"},"links":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Typed links, e.g. {\"goals\": [\"G-002\"]}"},"body":{"type":"string"},"sections":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"},"description":"Body H2 sections to set, keyed by heading text"}},"required":["type","title"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/update_artifact":{"post":{"operationId":"update_artifact","summary":"Update artifact","description":"Set frontmatter fields and/or replace the body or individual H2 sections. Only edited lines change.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"fields":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Frontmatter fields; dotted keys allowed (rice.reach); null removes"},"body":{"type":"string"},"sections":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"},"description":"Body H2 sections to set, keyed by heading text"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/replace_file":{"post":{"operationId":"replace_file","summary":"Replace file","description":"Replace an artifact's whole Markdown file (frontmatter + body). Prefer update_artifact; id and type are immutable.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"content":{"type":"string"}},"required":["id","content"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/link_artifacts":{"post":{"operationId":"link_artifacts","summary":"Link artifacts","description":"Add a typed link on the child side: from=INI-007 kind=goals to=G-002. Allowed kinds depend on the source type (see list_types).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"type":"string","description":"Artifact ID, e.g. INI-007"},"kind":{"type":"string"},"to":{"type":"string","description":"Artifact ID, e.g. INI-007"}},"required":["from","kind","to"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/unlink_artifacts":{"post":{"operationId":"unlink_artifacts","summary":"Unlink artifacts","description":"Remove a typed link.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"type":"string","description":"Artifact ID, e.g. INI-007"},"kind":{"type":"string"},"to":{"type":"string","description":"Artifact ID, e.g. INI-007"}},"required":["from","kind","to"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/delete_artifact":{"post":{"operationId":"delete_artifact","summary":"Delete artifact","description":"Delete an artifact that nothing links to. Humans only on review paths.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/get_graph":{"post":{"operationId":"get_graph","summary":"Traceability graph","description":"Nodes and edges around an artifact (goals ↔ initiatives ↔ opportunities ↔ feedback…).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"depth":{"default":2,"type":"integer","minimum":1,"maximum":4},"types":{"type":"array","items":{"type":"string"}}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/get_evidence":{"post":{"operationId":"get_evidence","summary":"Evidence","description":"Feedback items and insights backing an initiative or opportunity, with unique-account ARR.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/validate":{"post":{"operationId":"validate","summary":"Validate workspace","description":"Check every file against its schema, link targets and ID uniqueness. Run before finishing any task.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"errors_only":{"default":false,"type":"boolean"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/fix_workspace":{"post":{"operationId":"fix_workspace","summary":"Fix workspace","description":"Apply safe fixes (`kano validate --fix`): missing schema_version, status case, link ID formatting and duplicates, stored derived fields. One commit; never adds validation errors. Humans only.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"dry_run":{"default":false,"type":"boolean"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/migrate_workspace":{"post":{"operationId":"migrate_workspace","summary":"Migrate workspace","description":"Upgrade files to each type's current schema_version with the type's migrations (P3). One commit. Humans only.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"dry_run":{"default":false,"type":"boolean"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/get_config":{"post":{"operationId":"get_config","summary":"Get workspace settings","description":"kano.config.yaml as written (comments included), its parsed content and ConfigSchema as JSON Schema, for settings forms.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/update_config":{"post":{"operationId":"update_config","summary":"Update workspace settings","description":"Edit kano.config.yaml (ADR 0012): `set` dotted paths (agents.monthly_budget_usd, chat.model; null removes) as minimal YAML edits that keep comments, or replace the whole file with `yaml`. Validated with ConfigSchema before writing; unknown keys and secret-looking keys are rejected (secrets stay in env). One commit. Humans only.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"set":{"description":"Dotted paths to values, e.g. {\"agents.concurrency\": 3}; null removes","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"yaml":{"description":"Whole-file replacement (raw editor)","type":"string"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/get_context_pack":{"post":{"operationId":"get_context_pack","summary":"Context pack","description":"Compact Markdown bundle of vision, strategy, active goals, OKRs and personas to load before reasoning.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"pack":{"default":"default","type":"string"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/ingest_feedback":{"post":{"operationId":"ingest_feedback","summary":"Ingest feedback","description":"Create a feedback item (FR-7.3). Idempotent on source.system + source.external_id (FR-7.5): returns the existing item instead of creating a duplicate. For a stakeholder's request use channel \"internal\" and links {\"stakeholders\": [\"STK-001\"]} (FR-12.6).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"verbatim":{"type":"string","minLength":1},"title":{"type":"string"},"channel":{"default":"other","type":"string"},"customer":{"type":"object","properties":{"account":{"type":"string"},"arr":{"type":"number"},"segment":{"type":"string"}}},"source":{"default":{"system":"manual"},"type":"object","properties":{"system":{"type":"string"},"external_id":{"type":"string"},"url":{"type":"string"}},"required":["system"]},"received":{"type":"string"},"sentiment":{"type":"string","enum":["positive","neutral","negative"]},"category":{"type":"string"},"links":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Typed links, e.g. {\"goals\": [\"G-002\"]}"}},"required":["verbatim"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/record_metric":{"post":{"operationId":"record_metric","summary":"Record metric value","description":"Set a metric's current value and upsert the dated point in its history sidecar (FR-11.1).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"value":{"type":"number"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["id","value"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/history":{"post":{"operationId":"history","summary":"History","description":"Git history of an artifact.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"limit":{"default":30,"type":"integer","exclusiveMinimum":0,"maximum":200}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/list_reviews":{"post":{"operationId":"list_reviews","summary":"List reviews","description":"Open review proposals (agent branches) with their changed files.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/get_review":{"post":{"operationId":"get_review","summary":"Get review","description":"One review proposal with its full diff.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"branch":{"type":"string"}},"required":["branch"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/approve_review":{"post":{"operationId":"approve_review","summary":"Approve review","description":"Merge a proposal (all files, or only `files`). Humans only.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"branch":{"type":"string"},"files":{"type":"array","items":{"type":"string"}}},"required":["branch"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/reject_review":{"post":{"operationId":"reject_review","summary":"Reject review","description":"Discard a proposal; the note is appended to the agent's memory file.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"branch":{"type":"string"},"note":{"type":"string"}},"required":["branch"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/whoami":{"post":{"operationId":"whoami","summary":"Who am I","description":"The acting identity and role.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/list_users":{"post":{"operationId":"list_users","summary":"List users","description":"Everyone who has signed in, with their role.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/set_user_role":{"post":{"operationId":"set_user_role","summary":"Set user role","description":"Change a user's role: viewer, commenter, editor or admin.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"email":{"type":"string"},"role":{"type":"string","enum":["viewer","commenter","editor","admin"]}},"required":["email","role"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/upsert_user_account":{"post":{"operationId":"upsert_user_account","summary":"Create or update user account","description":"Create a local account or update a user's username, password, name and role.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"name":{"type":"string"},"username":{"type":["string","null"]},"role":{"type":"string","enum":["viewer","commenter","editor","admin"]},"password":{"type":"string","minLength":8}},"required":["email"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/set_my_password":{"post":{"operationId":"set_my_password","summary":"Update own password or username","description":"Set or change the current user's password and optional username.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"password":{"type":"string","minLength":8},"current_password":{"type":"string"},"username":{"type":["string","null"]}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/list_tokens":{"post":{"operationId":"list_tokens","summary":"List API tokens","description":"Your API tokens (admins: all tokens with all: true). Secrets are never shown again.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"all":{"default":false,"type":"boolean"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/create_token":{"post":{"operationId":"create_token","summary":"Create API token","description":"Create a token for the REST API and MCP over HTTP. Personal tokens act as you (at most your role). Admins can create agent tokens (agent: <slug>) limited to scope_write globs.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1},"role":{"type":"string","enum":["viewer","commenter","editor","admin"]},"agent":{"type":"string","pattern":"^[a-z0-9-]+$"},"scope_write":{"type":"array","items":{"type":"string"}},"expires_days":{"type":"integer","exclusiveMinimum":0,"maximum":3650}},"required":["name"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/create_share_link":{"post":{"operationId":"create_share_link","summary":"Create a share link","description":"A read-only link to the roadmap for stakeholders without an account (FR-4.4). The URL is shown once; revoke it any time.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"kind":{"default":"roadmap","type":"string","enum":["roadmap"]},"expires_days":{"type":"integer","exclusiveMinimum":0,"maximum":365}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/list_share_links":{"post":{"operationId":"list_share_links","summary":"List share links","description":"Read-only share links, with when they were last viewed.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/revoke_share_link":{"post":{"operationId":"revoke_share_link","summary":"Revoke share link","description":"Stop a share link from working.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/revoke_token":{"post":{"operationId":"revoke_token","summary":"Revoke API token","description":"Revoke one of your tokens (admins: any token).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/list_secrets":{"post":{"operationId":"list_secrets","summary":"List secrets","description":"API keys and connector credentials Kano knows about, grouped, with where each value comes from (env, vault or unset), who set it and when. Values are never returned.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/set_secret":{"post":{"operationId":"set_secret","summary":"Set secret","description":"Store an API key or credential in the encrypted vault, outside git (ADR 0020). A value set in the server environment takes precedence and cannot be replaced here. Humans only.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string"},"value":{"type":"string","minLength":1,"maxLength":20000}},"required":["name","value"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/clear_secret":{"post":{"operationId":"clear_secret","summary":"Clear secret","description":"Remove a secret from the vault. Features that need it stop until it is set again. Humans only.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string"}},"required":["name"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/audit_strategy":{"post":{"operationId":"audit_strategy","summary":"Audit strategy alignment","description":"Deterministic alignment checks: active goals with no initiative, initiatives with no goal, approved work without a PRD or evidence, live initiatives with no product (once products exist), stale bets, empty themes.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"stale_days":{"default":90,"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/check_delivery":{"post":{"operationId":"check_delivery","summary":"Check delivery health","description":"Deterministic delivery checks on roadmap items: overdue, ending after their release target, starting before a dependency ends, missing dates, Now initiatives without items.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"on":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/list_action_items":{"post":{"operationId":"list_action_items","summary":"List action items","description":"Action items from meeting minutes (FR-12.2) across all meetings, with computed overdue flags. Filter by open, owner (stakeholder ID or handle) or meeting.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"open":{"default":true,"type":"boolean"},"owner":{"type":"string"},"meeting":{"description":"Meeting ID, e.g. MTG-003","type":"string"},"on":{"description":"Date to compute overdue against; default today","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/set_action_item":{"post":{"operationId":"set_action_item","summary":"Update an action item","description":"Mark a meeting action item done or open, or change its owner/due date (FR-12.2). `index` is its position in the meeting's action_items list (from list_action_items).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"meeting":{"type":"string","description":"Artifact ID, e.g. INI-007"},"index":{"type":"integer","minimum":0,"maximum":9007199254740991},"done":{"type":"boolean"},"owner":{"type":"string"},"due":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"action":{"type":"string","minLength":1}},"required":["meeting","index"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/add_action_item":{"post":{"operationId":"add_action_item","summary":"Add an action item","description":"Append an action item to a meeting's minutes (FR-12.2). `owner` is a stakeholder ID or a Kano handle. Returns its `index` for set_action_item.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"meeting":{"type":"string","description":"Artifact ID, e.g. INI-007"},"action":{"type":"string","minLength":1},"owner":{"type":"string"},"due":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["meeting","action"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/audit_governance":{"post":{"operationId":"audit_governance","summary":"Audit governance","description":"Deterministic governance checks (FR-12.7): overdue action items, meetings held but not minuted, decisions proposed too long, accepted decisions without approvers, decisions past their review date.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"on":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/list_stakeholders":{"post":{"operationId":"list_stakeholders","summary":"List stakeholders","description":"Internal stakeholders (FR-12.5) with role, influence/interest and counts of meetings attended, decisions approved, requests raised and open action items.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/capture_note":{"post":{"operationId":"capture_note","summary":"Capture a note","description":"ADR 0019: save raw, unclassified text as a note (NOTE-xxxx) in the notes inbox: a thought, a to-do (use `- [ ]` lines), pasted meeting notes. The title defaults to the first line. New notes are triaged in the background when notes.auto_triage is on; run triage_note to triage now.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":100000},"title":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"related":{"description":"Existing artifacts the note is about, e.g. [\"INI-003\"]","type":"array","items":{"type":"string"}}},"required":["text"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/note_todos":{"post":{"operationId":"note_todos","summary":"List note to-dos","description":"ADR 0019: checklist items (`- [ ]` / `- [x]`) across notes, open ones only unless all=true. Computed from the bodies (P8).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"description":"One note; omit for every note that is not archived","type":"string"},"all":{"default":false,"type":"boolean"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/set_note_todo":{"post":{"operationId":"set_note_todo","summary":"Tick a note to-do","description":"ADR 0019: mark checklist item `index` (from note_todos) of a note done or open. Only that checkbox changes.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"index":{"type":"integer","minimum":0,"maximum":9007199254740991},"done":{"type":"boolean"}},"required":["id","index","done"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/accept_note_suggestion":{"post":{"operationId":"accept_note_suggestion","summary":"Accept a note suggestion","description":"ADR 0019: accept triage suggestion `index` of a note: creates the feedback / decision (always proposed) / opportunity / insight / initiative, or for kind `link` relates the note to existing artifacts, and links the note to it. Optional overrides edit the title, fields or links first. Humans only (P12).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"index":{"type":"integer","minimum":0,"maximum":9007199254740991},"title":{"type":"string"},"fields":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Frontmatter fields; dotted keys allowed (rice.reach); null removes"},"links":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"array","items":{"type":"string"}},"description":"Typed links, e.g. {\"goals\": [\"G-002\"]}"}},"required":["id","index"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/dismiss_note_suggestion":{"post":{"operationId":"dismiss_note_suggestion","summary":"Dismiss a note suggestion","description":"ADR 0019: dismiss triage suggestion `index` of a note; it is kept as dismissed so triage does not offer it again. Humans only (P12).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"index":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["id","index"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/roadmap_snapshot":{"post":{"operationId":"roadmap_snapshot","summary":"Snapshot the roadmap","description":"Save a dated, committed copy of the strategic and operational roadmap (FR-4.5) for later comparison, e.g. before a QBR.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"label":{"type":"string","maxLength":80}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/list_roadmap_snapshots":{"post":{"operationId":"list_roadmap_snapshots","summary":"List roadmap snapshots","description":"Saved roadmap snapshots, newest first.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/roadmap_diff":{"post":{"operationId":"roadmap_diff","summary":"What changed on the roadmap","description":"Changes between two roadmap states (FR-4.5): added/removed initiatives, horizon moves, status and quarter changes, delivery dates that slipped or were pulled in. from/to: a snapshot name, \"latest\" or \"now\".","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"from":{"default":"latest","type":"string"},"to":{"default":"now","type":"string"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/export_roadmap":{"post":{"operationId":"export_roadmap","summary":"Export the roadmap","description":"The roadmap as shareable Markdown (FR-4.4): narrative, Now/Next/Later by theme, quarters and upcoming releases. Optionally from a snapshot.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"snapshot":{"type":"string"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/close_the_loop":{"post":{"operationId":"close_the_loop","summary":"Close the loop","description":"For a shipped initiative: list the customers whose feedback it addressed (by account, ARR, source link), write a close-the-loop report and mark those feedback items closed. dry_run previews.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"dry_run":{"default":false,"type":"boolean"},"force":{"default":false,"type":"boolean"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/list_comments":{"post":{"operationId":"list_comments","summary":"List comments","description":"Comments on an artifact (FR-8.13): id, author, time, reply-to, resolved, text, @mentions.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"include_resolved":{"default":true,"type":"boolean"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/add_comment":{"post":{"operationId":"add_comment","summary":"Add comment","description":"Comment on an artifact, optionally replying to a comment (reply_to: c-…). @agent-slug mentions ask that agent to run and reply. Comments are discussion: they apply directly, without review.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"text":{"type":"string","minLength":1},"reply_to":{"type":"string","pattern":"^c-[0-9a-f]{6}$"}},"required":["id","text"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/resolve_comment":{"post":{"operationId":"resolve_comment","summary":"Resolve comment","description":"Mark a comment thread resolved (or reopen it).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Artifact ID, e.g. INI-007"},"comment_id":{"type":"string"},"resolved":{"default":true,"type":"boolean"}},"required":["id","comment_id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/sync_status":{"post":{"operationId":"sync_status","summary":"Git sync status","description":"State of the git remote sync (13.2): last sync, pulls, pushes, and any conflict with the branch that holds local work.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/sync_now":{"post":{"operationId":"sync_now","summary":"Sync with git remote","description":"Commit pending edits, pull, merge and push now.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/list_agents":{"post":{"operationId":"list_agents","summary":"List agents","description":"Agent definitions with status, model, triggers, next scheduled run and last run.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/run_agent":{"post":{"operationId":"run_agent","summary":"Run agent","description":"Queue a Kano agent run (optionally a dry run that merges nothing). With wait=true, returns the finished run.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"agent":{"type":"string","description":"Agent slug or ID, e.g. feedback-rationalizer or AGT-002"},"input":{"description":"Extra instructions for this run","type":"string"},"dry_run":{"default":false,"type":"boolean"},"wait":{"default":false,"type":"boolean"}},"required":["agent"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/list_runs":{"post":{"operationId":"list_runs","summary":"List runs","description":"Agent runs, newest first: queued/running ones plus run records.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"agent":{"type":"string"},"status":{"type":"string"},"limit":{"default":50,"type":"integer","exclusiveMinimum":0,"maximum":500}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/get_run":{"post":{"operationId":"get_run","summary":"Get run","description":"One run: its record (summary, changes, log) or, while running, its live log.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/cancel_run":{"post":{"operationId":"cancel_run","summary":"Cancel run","description":"Cancel a queued or running agent run. Nothing it wrote is merged.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/revert_run":{"post":{"operationId":"revert_run","summary":"Revert run","description":"Revert every commit an agent run merged and discard its open proposal (P13).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/list_skills":{"post":{"operationId":"list_skills","summary":"List skills","description":"Skills available to agents and Claude Code: name, description, origin, enabled, and whether a workspace copy overrides a built-in.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/get_skill":{"post":{"operationId":"get_skill","summary":"Get skill","description":"Full SKILL.md of a skill, frontmatter included.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string"}},"required":["name"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/save_skill":{"post":{"operationId":"save_skill","summary":"Save skill","description":"Create or edit a skill's SKILL.md. Built-ins are copied to plugins/local/skills/<name>/ in the workspace and edited there. Humans only.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string"},"content":{"type":"string","minLength":1}},"required":["name","content"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/reset_skill":{"post":{"operationId":"reset_skill","summary":"Reset skill","description":"Delete a workspace skill. For an override this restores the built-in version. Humans only.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string"}},"required":["name"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/set_skill_enabled":{"post":{"operationId":"set_skill_enabled","summary":"Enable or disable skill","description":"Enable or disable a skill for Kano agents (kano.config.yaml skills.disabled). Humans only.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string"},"enabled":{"type":"boolean"}},"required":["name","enabled"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/draft_agent":{"post":{"operationId":"draft_agent","summary":"Draft an agent from a description","description":"FR-10.4: describe what an agent should do in plain language; a meta-agent drafts its definition (instructions, skills, tools, triggers, scope), validated against what is installed. Returns the draft for review; nothing is written.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"description":{"type":"string","minLength":10,"maxLength":4000}},"required":["description"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/create_agent":{"post":{"operationId":"create_agent","summary":"Create an agent","description":"Create agents/<slug>/agent.md from a reviewed draft (from draft_agent). The agent starts disabled; enable it after a dry run.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"draft":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":60},"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]*$"},"instructions":{"type":"string","minLength":1},"skills":{"type":"array","items":{"type":"string"}},"tools":{"type":"array","items":{"type":"string"}},"triggers":{"type":"array","items":{"type":"object","properties":{"schedule":{"type":"string"},"event":{"type":"string"},"types":{"type":"array","items":{"type":"string"}},"debounce_minutes":{"type":"number"}}}},"scope_write":{"type":"array","items":{"type":"string"}},"approval_required":{"type":"array","items":{"type":"string"}},"effort":{"type":"string","enum":["low","medium","high"]}},"required":["title","slug","instructions","skills","tools","triggers","scope_write","approval_required","effort"]}},"required":["draft"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/label_feedback":{"post":{"operationId":"label_feedback","summary":"Label feedback with the model","description":"FR-7.3: give a feedback item a concise title, a category and a sentiment with the chat model. Only fields still at their defaults change (an auto title, empty category or sentiment). New feedback is labelled automatically when chat.enrich_feedback is on.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/weave_artifact":{"post":{"operationId":"weave_artifact","summary":"Weave links with the model","description":"ADR 0017: let the Weaver judge suggest_links candidates for an artifact with its model (weave.provider/model, else the agents default), add the links it is sure of (subject to path policy), propose the doubtful ones for review and comment on likely duplicates. New artifacts are woven automatically when weave.agent is on.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/triage_note":{"post":{"operationId":"triage_note","summary":"Triage a note with AI","description":"ADR 0019: read a raw note with the chat model and store suggestions on it: feedback, decisions, opportunities, insights or initiative ideas found in the text, linked to existing artifacts, or links to artifacts it is about. Replaces pending suggestions; accepted and dismissed ones are kept. A human accepts each with accept_note_suggestion. New notes are triaged automatically when notes.auto_triage is on.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/rewrite_text":{"post":{"operationId":"rewrite_text","summary":"Rewrite text with AI","description":"FR-8.12: rewrite text in an artifact so it follows the best-practice format of its type (a user story with acceptance criteria for a roadmap item, a measurable time-bound outcome for a goal, …). Rewrites `text` (a selection), one `section`, or the whole body of `id`. Returns a proposal; nothing is written. To apply it, splice `proposed` over `range` in the body (section and body scopes) or over the selection. Per-type guides live in the rewrite-text skill (one `## <type>` section each) or a rewrite-<type> skill.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"description":"Artifact whose text is rewritten, e.g. OPS-010","type":"string"},"type":{"description":"Artifact type, when there is no artifact (requires text)","type":"string"},"text":{"description":"The selected text to rewrite; omit to rewrite the section or the whole body","type":"string","maxLength":40000},"section":{"description":"H2 section the text is in, or the section to rewrite","type":"string"},"instructions":{"description":"Extra instructions, e.g. \"shorter\", \"add acceptance criteria\"","type":"string","maxLength":2000}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/list_integrations":{"post":{"operationId":"list_integrations","summary":"List integrations","description":"Connectors with their status: enabled, schedule, missing secrets, next run and last sync counts.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/integrations_overview":{"post":{"operationId":"integrations_overview","summary":"Integrations overview","description":"Everything the Integrations page shows, in one call (ADR 0020): each connector's status and Connect fields, its recent syncs, Google Chat's status, and for admins each connector's settings file and schema. A paired Mac asks its deployment once instead of once per connector.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"log_limit":{"default":8,"type":"integer","minimum":0,"maximum":50}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/test_integration":{"post":{"operationId":"test_integration","summary":"Test integration","description":"Check a connector's credentials and config against the external system.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/connect_integration":{"post":{"operationId":"connect_integration","summary":"Connect integration (OAuth)","description":"Start the OAuth authorization code flow for a connector that needs consent (Zendesk): returns the provider URL to open in a browser. The web app's Connect button calls this; the provider redirects to redirect_uri with code and state.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"redirect_uri":{"type":"string","format":"uri"},"state":{"type":"string","minLength":16}},"required":["id","redirect_uri","state"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/finish_connect_integration":{"post":{"operationId":"finish_connect_integration","summary":"Finish connecting integration (OAuth)","description":"Exchange the authorization code from the provider's redirect for tokens, store them outside git and test the connection.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"code":{"type":"string","minLength":1},"redirect_uri":{"type":"string","format":"uri"}},"required":["id","code","redirect_uri"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/save_integration_credentials":{"post":{"operationId":"save_integration_credentials","summary":"Save integration credentials","description":"Connect a connector from the UI (ADR 0020): settings such as base_url go in integrations/<id>.yaml (one commit), secrets such as API tokens in the encrypted vault outside git. Empty or omitted values are left as they are. Runs the connector test when everything is set. Values set in the server environment take precedence and cannot be replaced here. Humans only.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"values":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string","maxLength":20000},"description":"Field name (e.g. JIRA_API_TOKEN) → value; see list_integrations fields"}},"required":["id","values"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/disconnect_integration":{"post":{"operationId":"disconnect_integration","summary":"Disconnect integration","description":"OAuth connectors: forget the stored tokens (the OAuth client stays). Others: remove their secrets from the vault (settings and env values stay). Syncs stop until an admin connects it again; revoke the grant or token at the provider too.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/sync_integration":{"post":{"operationId":"sync_integration","summary":"Sync integration","description":"Pull from a connector now and apply its mapping (FR-11.1). Idempotent; fields are written per their ownership. dry_run previews without writing. Incremental from the last cursor unless full is set.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"dry_run":{"default":false,"type":"boolean"},"full":{"default":false,"type":"boolean"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/integration_log":{"post":{"operationId":"integration_log","summary":"Integration sync log","description":"Recent syncs of a connector, newest first, with created/updated/skipped/errored counts and per-record errors.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"limit":{"default":20,"type":"integer","minimum":1,"maximum":100}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/configure_integration":{"post":{"operationId":"configure_integration","summary":"Configure integration","description":"Enable/disable a connector or change its cron schedule in integrations/<id>.yaml (humans only).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"enabled":{"type":"boolean"},"schedule":{"type":["string","null"]}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/get_integration_config":{"post":{"operationId":"get_integration_config","summary":"Get integration config","description":"integrations/<id>.yaml as written, the connector's settings from it, their JSON Schema (for generated forms), which env secrets are set (never their values) and any validation problem.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/update_integration_config":{"post":{"operationId":"update_integration_config","summary":"Update integration config","description":"Edit a connector's settings in integrations/<id>.yaml (FR-11.1, ADR 0012), e.g. Google Sheets' sheets and column mapping. `config` is the full settings object validated against the connector's schema and written as minimal YAML edits that keep comments (enabled, schedule and ownership are left alone; omitted keys fall back to defaults); `yaml` replaces the whole file after the same validation. Secrets stay in env. One commit. Humans only.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"config":{"description":"The connector's settings; see get_integration_config for the schema","type":"object","propertyNames":{"type":"string"},"additionalProperties":{}},"yaml":{"description":"Whole-file replacement (raw editor)","type":"string"}},"required":["id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/import_feedback_csv":{"post":{"operationId":"import_feedback_csv","summary":"Import feedback CSV","description":"Import feedback from CSV text with a column mapping (FR-11.5). Idempotent: rows without an external ID column are keyed by a hash of verbatim + account.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"csv":{"type":"string"},"mapping":{"type":"object","properties":{"verbatim":{"type":"string"},"title":{"type":"string"},"account":{"type":"string"},"arr":{"type":"string"},"segment":{"type":"string"},"channel":{"type":"string"},"received":{"type":"string"},"external_id":{"type":"string"},"url":{"type":"string"}},"required":["verbatim"]},"system":{"default":"csv","type":"string"},"channel":{"type":"string"},"dry_run":{"default":false,"type":"boolean"}},"required":["csv","mapping"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/google_chat_status":{"post":{"operationId":"google_chat_status","summary":"Google Chat status","description":"Whether the Google Chat app is configured: notification space, what it posts, feedback spaces.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/google_chat_test":{"post":{"operationId":"google_chat_test","summary":"Send a Google Chat test message","description":"Post a test message to the configured notification space.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/delivery_status":{"post":{"operationId":"delivery_status","summary":"Delivery tracker status","description":"Which delivery tracker (delivery.tool: jira, linear, asana or none) links epics and stories, and whether its picker can search (integration connected).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/search_delivery_items":{"post":{"operationId":"search_delivery_items","summary":"Search delivery items","description":"Typeahead over the delivery tracker (read-only, FR-3.7): kind=epic finds epics (for an initiative's jira_epic), kind=issue finds any epic, story or task (for a roadmap item's jira_key). An exact key matches first; empty query lists the most recently updated. Scoped to the projects in integrations/jira.yaml link.projects.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"default":"","type":"string","maxLength":200},"kind":{"default":"issue","type":"string","enum":["epic","issue"]},"limit":{"default":20,"type":"integer","minimum":1,"maximum":50}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/jira_search":{"post":{"operationId":"jira_search","summary":"Search Jira","description":"Search Jira issues with JQL (read-only). Returns key, summary, status, assignee, due date and URL.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"jql":{"type":"string"},"max_results":{"default":20,"type":"integer","minimum":1,"maximum":50}},"required":["jql"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/jira_get_issue":{"post":{"operationId":"jira_get_issue","summary":"Get Jira issue","description":"Read one Jira issue by key (read-only), with its description as plain text.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"key":{"type":"string"}},"required":["key"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/posthog_query":{"post":{"operationId":"posthog_query","summary":"Query PostHog (HogQL)","description":"Run a read-only HogQL query against PostHog. Returns columns and up to 200 rows.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/posthog_get_insight":{"post":{"operationId":"posthog_get_insight","summary":"Get PostHog insight","description":"Read a saved PostHog insight by short ID: name, headline value and (trimmed) result.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"short_id":{"type":"string"}},"required":["short_id"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/posthog_list_events":{"post":{"operationId":"posthog_list_events","summary":"List PostHog events","description":"List event names defined in PostHog, optionally filtered by a search string.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"search":{"type":"string"}}}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/salesforce_soql":{"post":{"operationId":"salesforce_soql","summary":"Query Salesforce (SOQL)","description":"Run a read-only SOQL SELECT on allow-listed objects (Account, Opportunity, Case by default). Returns up to 200 records.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string"}},"required":["query"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}},"/api/ops/zendesk_search":{"post":{"operationId":"zendesk_search","summary":"Search Zendesk","description":"Search Zendesk tickets (read-only) with Zendesk search syntax, e.g. 'tags:feature_request sso'. Returns id, subject, status, tags, dates and URL.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"query":{"type":"string"},"max_results":{"default":20,"type":"integer","minimum":1,"maximum":50}},"required":["query"]}}}},"responses":{"200":{"description":"OK"},"400":{"description":"Invalid input"},"403":{"description":"Policy denied"},"404":{"description":"Not found"},"422":{"description":"Validation failed"}}}}}}