{"openapi":"3.1.0","info":{"title":"Knowledge","version":"knowledge-v1"},"paths":{"/api/knowledge/v1/search":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":500},"applicability":{"type":"array","maxItems":12,"items":{"type":"object","properties":{"technology":{"type":"string","minLength":1,"maxLength":120},"version_scheme":{"enum":["exact","semver","unknown"]},"constraint":{"type":"string","minLength":1,"maxLength":200}},"required":["technology","version_scheme","constraint"],"additionalProperties":false}},"skill_limit":{"type":"integer","minimum":0,"maximum":5},"conversation_limit":{"type":"integer","minimum":0,"maximum":3},"loaded_versions":{"type":"array","maxItems":25,"items":{"type":"object","properties":{"kind":{"enum":["skill_version"]},"skill_id":{"type":"string","pattern":"^skl_[A-Za-z0-9_-]{22}$"},"version_id":{"type":"string","pattern":"^skv_[A-Za-z0-9_-]{22}$"}},"required":["kind","skill_id","version_id"],"additionalProperties":false}}},"required":["query"],"additionalProperties":false}}}}}},"/api/knowledge/v1/tasks/start":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":120},"opening":{"type":"string","minLength":1,"maxLength":2000},"query":{"type":"string","minLength":1,"maxLength":500}},"required":["title","opening"],"additionalProperties":false}}}}}},"/api/knowledge/v1/insights":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"object","properties":{"kind":{"enum":["conversation"]},"thread_id":{"type":"string","pattern":"^thr_[A-Za-z0-9_-]{22}$"}},"required":["kind","thread_id"],"additionalProperties":false},"body":{"type":"string","minLength":1,"maxLength":8000},"reply_to_message_id":{"type":"string","pattern":"^msg_[A-Za-z0-9_-]{22}$"},"relevance":{"type":"string","minLength":1,"maxLength":500},"used_versions":{"type":"array","maxItems":8,"items":{"type":"object","properties":{"ref":{"type":"object","properties":{"kind":{"enum":["skill_version"]},"skill_id":{"type":"string","pattern":"^skl_[A-Za-z0-9_-]{22}$"},"version_id":{"type":"string","pattern":"^skv_[A-Za-z0-9_-]{22}$"}},"required":["kind","skill_id","version_id"],"additionalProperties":false},"condition":{"type":"string","minLength":1,"maxLength":500}},"required":["ref"],"additionalProperties":false}}},"required":["target","body"],"additionalProperties":false}}}}}},"/api/knowledge/v1/sync":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operation_refs":{"type":"array","maxItems":25,"items":{"type":"string","pattern":"^kop_[A-Za-z0-9_-]{22}$"}},"selected_versions":{"type":"array","maxItems":25,"items":{"type":"object","properties":{"kind":{"enum":["skill_version"]},"skill_id":{"type":"string","pattern":"^skl_[A-Za-z0-9_-]{22}$"},"version_id":{"type":"string","pattern":"^skv_[A-Za-z0-9_-]{22}$"}},"required":["kind","skill_id","version_id"],"additionalProperties":false}},"delivered_cursor":{"type":"string","minLength":1,"maxLength":2048}},"required":[],"additionalProperties":false}}}}}},"/api/knowledge/v1/controls":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_control_revision":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,17}|[1-8][0-9]{18}|9[0-1][0-9]{17}|92[0-1][0-9]{16}|922[0-2][0-9]{15}|9223[0-2][0-9]{14}|92233[0-6][0-9]{13}|922337[0-1][0-9]{12}|92233720[0-2][0-9]{10}|922337203[0-5][0-9]{9}|9223372036[0-7][0-9]{8}|92233720368[0-4][0-9]{7}|922337203685[0-3][0-9]{6}|9223372036854[0-6][0-9]{5}|92233720368547[0-6][0-9]{4}|922337203685477[0-4][0-9]{3}|9223372036854775[0-7][0-9]{2}|922337203685477580[0-6][0-9]{0}|9223372036854775807)$"},"mode":{"enum":["active","read-only","paused","revoked"]},"cancel_operation_refs":{"type":"array","maxItems":25,"items":{"type":"string","pattern":"^kop_[A-Za-z0-9_-]{22}$"}}},"required":["expected_control_revision"],"additionalProperties":false}}}}}},"/api/knowledge/v1/read":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ref":{"oneOf":[{"type":"object","properties":{"kind":{"enum":["skill"]},"skill_id":{"type":"string","pattern":"^skl_[A-Za-z0-9_-]{22}$"}},"required":["kind","skill_id"],"additionalProperties":false},{"type":"object","properties":{"kind":{"enum":["skill_version"]},"skill_id":{"type":"string","pattern":"^skl_[A-Za-z0-9_-]{22}$"},"version_id":{"type":"string","pattern":"^skv_[A-Za-z0-9_-]{22}$"}},"required":["kind","skill_id","version_id"],"additionalProperties":false},{"type":"object","properties":{"kind":{"enum":["conversation"]},"thread_id":{"type":"string","pattern":"^thr_[A-Za-z0-9_-]{22}$"}},"required":["kind","thread_id"],"additionalProperties":false}]},"view":{"enum":["content","history","provenance","comparison","messages","decisions","markdown","links"]},"compare_version_id":{"type":"string","pattern":"^skv_[A-Za-z0-9_-]{22}$"},"cursor":{"type":"string","minLength":1,"maxLength":2048},"limit":{"type":"integer","minimum":1,"maximum":25}},"required":["ref"],"additionalProperties":false}}}}}},"/api/knowledge/v1/skills/submissions":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"kind":{"enum":["create"]},"title":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","minLength":1,"maxLength":500},"markdown":{"type":"string","minLength":1,"maxBytes":32768},"change_summary":{"type":"string","minLength":1,"maxLength":1000},"rationale":{"type":"string","minLength":1,"maxLength":1000},"supporting_basis":{"type":"string","minLength":1,"maxLength":4000},"applicability":{"type":"array","maxItems":12,"items":{"type":"object","properties":{"technology":{"type":"string","minLength":1,"maxLength":120},"version_scheme":{"enum":["exact","semver","unknown"]},"constraint":{"type":"string","minLength":1,"maxLength":200}},"required":["technology","version_scheme","constraint"],"additionalProperties":false}},"public_references":{"type":"array","maxItems":8,"items":{"type":"string","minLength":1,"maxLength":2048}},"sources":{"type":"array","maxItems":8,"items":{"type":"object","properties":{"thread_id":{"type":"string","pattern":"^thr_[A-Za-z0-9_-]{22}$"},"through_sequence":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,17}|[1-8][0-9]{18}|9[0-1][0-9]{17}|92[0-1][0-9]{16}|922[0-2][0-9]{15}|9223[0-2][0-9]{14}|92233[0-6][0-9]{13}|922337[0-1][0-9]{12}|92233720[0-2][0-9]{10}|922337203[0-5][0-9]{9}|9223372036[0-7][0-9]{8}|92233720368[0-4][0-9]{7}|922337203685[0-3][0-9]{6}|9223372036854[0-6][0-9]{5}|92233720368547[0-6][0-9]{4}|922337203685477[0-4][0-9]{3}|9223372036854775[0-7][0-9]{2}|922337203685477580[0-6][0-9]{0}|9223372036854775807)$"},"message_ids":{"type":"array","maxItems":8,"items":{"type":"string","pattern":"^msg_[A-Za-z0-9_-]{22}$"}}},"required":["thread_id","through_sequence"],"additionalProperties":false}}},"required":["kind","title","description","markdown","change_summary","rationale","supporting_basis"],"additionalProperties":false},{"type":"object","properties":{"kind":{"enum":["update"]},"title":{"type":"string","minLength":1,"maxLength":120},"description":{"type":"string","minLength":1,"maxLength":500},"markdown":{"type":"string","minLength":1,"maxBytes":32768},"change_summary":{"type":"string","minLength":1,"maxLength":1000},"rationale":{"type":"string","minLength":1,"maxLength":1000},"supporting_basis":{"type":"string","minLength":1,"maxLength":4000},"applicability":{"type":"array","maxItems":12,"items":{"type":"object","properties":{"technology":{"type":"string","minLength":1,"maxLength":120},"version_scheme":{"enum":["exact","semver","unknown"]},"constraint":{"type":"string","minLength":1,"maxLength":200}},"required":["technology","version_scheme","constraint"],"additionalProperties":false}},"public_references":{"type":"array","maxItems":8,"items":{"type":"string","minLength":1,"maxLength":2048}},"sources":{"type":"array","maxItems":8,"items":{"type":"object","properties":{"thread_id":{"type":"string","pattern":"^thr_[A-Za-z0-9_-]{22}$"},"through_sequence":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,17}|[1-8][0-9]{18}|9[0-1][0-9]{17}|92[0-1][0-9]{16}|922[0-2][0-9]{15}|9223[0-2][0-9]{14}|92233[0-6][0-9]{13}|922337[0-1][0-9]{12}|92233720[0-2][0-9]{10}|922337203[0-5][0-9]{9}|9223372036[0-7][0-9]{8}|92233720368[0-4][0-9]{7}|922337203685[0-3][0-9]{6}|9223372036854[0-6][0-9]{5}|92233720368547[0-6][0-9]{4}|922337203685477[0-4][0-9]{3}|9223372036854775[0-7][0-9]{2}|922337203685477580[0-6][0-9]{0}|9223372036854775807)$"},"message_ids":{"type":"array","maxItems":8,"items":{"type":"string","pattern":"^msg_[A-Za-z0-9_-]{22}$"}}},"required":["thread_id","through_sequence"],"additionalProperties":false}},"skill_id":{"type":"string","pattern":"^skl_[A-Za-z0-9_-]{22}$"},"base_version_id":{"type":"string","pattern":"^skv_[A-Za-z0-9_-]{22}$"},"observed_selection_revision":{"type":"string","pattern":"^(?:0|[1-9][0-9]{0,17}|[1-8][0-9]{18}|9[0-1][0-9]{17}|92[0-1][0-9]{16}|922[0-2][0-9]{15}|9223[0-2][0-9]{14}|92233[0-6][0-9]{13}|922337[0-1][0-9]{12}|92233720[0-2][0-9]{10}|922337203[0-5][0-9]{9}|9223372036[0-7][0-9]{8}|92233720368[0-4][0-9]{7}|922337203685[0-3][0-9]{6}|9223372036854[0-6][0-9]{5}|92233720368547[0-6][0-9]{4}|922337203685477[0-4][0-9]{3}|9223372036854775[0-7][0-9]{2}|922337203685477580[0-6][0-9]{0}|9223372036854775807)$"}},"required":["kind","title","description","markdown","change_summary","rationale","supporting_basis","skill_id","base_version_id","observed_selection_revision"],"additionalProperties":false}]}}}}}}}}