From 83643f725acd83cfb81ac091d4fd52bc2b02b917 Mon Sep 17 00:00:00 2001 From: kl3inIT Date: Fri, 7 Aug 2026 08:59:50 +0000 Subject: [PATCH 1/2] fix(assistant): enforce message limit before streaming --- .../2026-08-07-assistant-message-length.md | 11 +++ .../api/assistant/AssistantChatRequest.java | 2 +- .../AssistantChatRequestValidationTests.java | 77 +++++++++++++++++++ .../assistant/assistant-draft-storage.test.ts | 13 +++- .../assistant/assistant-draft-storage.ts | 10 ++- .../assistant-message-constraints.ts | 1 + .../assistant/components/assistant-page.tsx | 23 +++++- apps/web/test/e2e/assistant-pipeline.spec.ts | 21 +++++ contracts/openapi.json | 2 +- 9 files changed, 151 insertions(+), 9 deletions(-) create mode 100644 .tegami/2026-08-07-assistant-message-length.md create mode 100644 apps/api/src/test/java/com/orgmemory/api/assistant/AssistantChatRequestValidationTests.java create mode 100644 apps/web/src/features/assistant/assistant-message-constraints.ts diff --git a/.tegami/2026-08-07-assistant-message-length.md b/.tegami/2026-08-07-assistant-message-length.md new file mode 100644 index 00000000..ad3e7df5 --- /dev/null +++ b/.tegami/2026-08-07-assistant-message-length.md @@ -0,0 +1,11 @@ +--- +packages: + orgmemory: patch +subject: Enforce the supported Assistant question length +--- + +## Fixes + +The Assistant composer now displays and enforces the 1,000-character question +limit before a turn starts. Questions at the boundary remain accepted, while +longer input is blocked instead of opening a stream that later fails. diff --git a/apps/api/src/main/java/com/orgmemory/api/assistant/AssistantChatRequest.java b/apps/api/src/main/java/com/orgmemory/api/assistant/AssistantChatRequest.java index 27753f37..eff892b2 100644 --- a/apps/api/src/main/java/com/orgmemory/api/assistant/AssistantChatRequest.java +++ b/apps/api/src/main/java/com/orgmemory/api/assistant/AssistantChatRequest.java @@ -5,7 +5,7 @@ import java.util.UUID; record AssistantChatRequest( - @NotBlank @Size(max = 4_000) String message, + @NotBlank @Size(max = 1_000) String message, Integer limit, UUID conversationId, UUID modelActivationId) { diff --git a/apps/api/src/test/java/com/orgmemory/api/assistant/AssistantChatRequestValidationTests.java b/apps/api/src/test/java/com/orgmemory/api/assistant/AssistantChatRequestValidationTests.java new file mode 100644 index 00000000..3fbfc292 --- /dev/null +++ b/apps/api/src/test/java/com/orgmemory/api/assistant/AssistantChatRequestValidationTests.java @@ -0,0 +1,77 @@ +package com.orgmemory.api.assistant; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.mockito.Mockito.mock; +import static org.mockito.Mockito.verifyNoInteractions; +import static org.springframework.http.MediaType.APPLICATION_JSON; +import static org.springframework.http.MediaType.TEXT_EVENT_STREAM; +import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; +import static org.springframework.test.web.servlet.setup.MockMvcBuilders.standaloneSetup; + +import com.orgmemory.api.security.CurrentActorProvider; +import com.orgmemory.core.ai.AssistantModelAuthorityService; +import com.orgmemory.core.assistant.AssistantConversationService; +import com.orgmemory.core.assistant.AssistantService; +import com.orgmemory.core.knowledge.retrieval.CitationEvidenceService; +import jakarta.validation.Validation; +import org.junit.jupiter.api.Test; +import tools.jackson.databind.ObjectMapper; + +class AssistantChatRequestValidationTests { + + @Test + void enforcesTheMessageLimitBoundary() { + try (var factory = Validation.buildDefaultValidatorFactory()) { + var validator = factory.getValidator(); + var accepted = validator.validate( + new AssistantChatRequest("a".repeat(1_000), null, null, null)); + var rejected = validator.validate( + new AssistantChatRequest("a".repeat(1_001), null, null, null)); + + assertEquals(0, accepted.size()); + assertEquals(1, rejected.size()); + assertEquals( + "message", + rejected.iterator().next().getPropertyPath().toString()); + } + } + + @Test + void rejectsAnOversizedMessageBeforeOpeningTheStreamOrCreatingATurn() throws Exception { + var assistant = mock(AssistantService.class); + var conversations = mock(AssistantConversationService.class); + var actors = mock(CurrentActorProvider.class); + var properties = mock(AssistantProperties.class); + var modelAuthority = mock(AssistantModelAuthorityService.class); + var citationEvidence = mock(CitationEvidenceService.class); + var retrievalScheduler = mock(AssistantRetrievalScheduler.class); + var json = mock(ObjectMapper.class); + var mvc = standaloneSetup(new AssistantController( + assistant, + conversations, + actors, + properties, + modelAuthority, + citationEvidence, + retrievalScheduler, + json)) + .build(); + + mvc.perform(post("/api/assistant/chat") + .contentType(APPLICATION_JSON) + .accept(TEXT_EVENT_STREAM) + .content("{\"message\":\"" + "a".repeat(1_001) + "\"}")) + .andExpect(status().isBadRequest()); + + verifyNoInteractions( + assistant, + conversations, + actors, + properties, + modelAuthority, + citationEvidence, + retrievalScheduler, + json); + } +} diff --git a/apps/web/src/features/assistant/assistant-draft-storage.test.ts b/apps/web/src/features/assistant/assistant-draft-storage.test.ts index 6f260ac1..ebb5eae9 100644 --- a/apps/web/src/features/assistant/assistant-draft-storage.test.ts +++ b/apps/web/src/features/assistant/assistant-draft-storage.test.ts @@ -21,9 +21,18 @@ describe("assistant draft storage", () => { expect(readAssistantDraft("actor-b", "conversation-1")).toBe("other actor") }) + it("bounds drafts persisted by an older client", () => { + sessionStorage.setItem( + "orgmemory:assistant-draft:v1:actor-a:new", + "x".repeat(1_100), + ) + + expect(readAssistantDraft("actor-a")).toHaveLength(1_000) + }) + it("caps drafts at the server message limit and clears lifecycle scopes", () => { - const bounded = writeAssistantDraft("actor-a", "conversation-1", "x".repeat(4_100)) - expect(bounded).toHaveLength(4_000) + const bounded = writeAssistantDraft("actor-a", "conversation-1", "x".repeat(1_100)) + expect(bounded).toHaveLength(1_000) clearAssistantDraft("actor-a", "conversation-1") expect(readAssistantDraft("actor-a", "conversation-1")).toBe("") diff --git a/apps/web/src/features/assistant/assistant-draft-storage.ts b/apps/web/src/features/assistant/assistant-draft-storage.ts index d771c7f6..d3dd1e97 100644 --- a/apps/web/src/features/assistant/assistant-draft-storage.ts +++ b/apps/web/src/features/assistant/assistant-draft-storage.ts @@ -1,5 +1,6 @@ +import { ASSISTANT_MESSAGE_MAX_CHARACTERS } from "@/features/assistant/assistant-message-constraints" + const DRAFT_PREFIX = "orgmemory:assistant-draft:v1:" -const MAX_DRAFT_LENGTH = 4_000 function draftKey(actorKey: string, conversationId?: string) { return `${DRAFT_PREFIX}${encodeURIComponent(actorKey)}:${conversationId ?? "new"}` @@ -7,7 +8,10 @@ function draftKey(actorKey: string, conversationId?: string) { export function readAssistantDraft(actorKey: string, conversationId?: string) { try { - return sessionStorage.getItem(draftKey(actorKey, conversationId)) ?? "" + return (sessionStorage.getItem(draftKey(actorKey, conversationId)) ?? "").slice( + 0, + ASSISTANT_MESSAGE_MAX_CHARACTERS, + ) } catch { return "" } @@ -18,7 +22,7 @@ export function writeAssistantDraft( conversationId: string | undefined, value: string, ) { - const bounded = value.slice(0, MAX_DRAFT_LENGTH) + const bounded = value.slice(0, ASSISTANT_MESSAGE_MAX_CHARACTERS) const key = draftKey(actorKey, conversationId) try { if (bounded.length === 0) { diff --git a/apps/web/src/features/assistant/assistant-message-constraints.ts b/apps/web/src/features/assistant/assistant-message-constraints.ts new file mode 100644 index 00000000..fb453194 --- /dev/null +++ b/apps/web/src/features/assistant/assistant-message-constraints.ts @@ -0,0 +1 @@ +export const ASSISTANT_MESSAGE_MAX_CHARACTERS = 1_000 diff --git a/apps/web/src/features/assistant/components/assistant-page.tsx b/apps/web/src/features/assistant/components/assistant-page.tsx index 722c6989..88f9376b 100644 --- a/apps/web/src/features/assistant/components/assistant-page.tsx +++ b/apps/web/src/features/assistant/components/assistant-page.tsx @@ -52,6 +52,7 @@ import { Source, Sources, SourcesContent, SourcesTrigger } from "@/components/ai import { Suggestion, Suggestions } from "@/components/ai-elements/suggestion" import { Button } from "@/components/ui/button" import { createAssistantTransport } from "@/features/assistant/api/chat-transport" +import { ASSISTANT_MESSAGE_MAX_CHARACTERS } from "@/features/assistant/assistant-message-constraints" import { activityLabel, hasVisibleAssistantOutput, @@ -741,6 +742,12 @@ export function AssistantPage({ function send(rawMessage: string, clearComposer = true) { const message = rawMessage.trim() + if (message.length > ASSISTANT_MESSAGE_MAX_CHARACTERS) { + toast.error( + `Messages can be at most ${ASSISTANT_MESSAGE_MAX_CHARACTERS.toLocaleString("en-US")} characters.`, + ) + return + } if ( !message || busy || @@ -806,10 +813,15 @@ export function AssistantPage({ setText(event.currentTarget.value)} + onChange={(event) => + setText( + event.currentTarget.value.slice(0, ASSISTANT_MESSAGE_MAX_CHARACTERS), + ) + } placeholder="Ask OrgMemory…" autoFocus - maxLength={4_000} + maxLength={ASSISTANT_MESSAGE_MAX_CHARACTERS} + aria-describedby="assistant-message-length" className="min-h-12" /> @@ -822,6 +834,13 @@ export function AssistantPage({ loading={modelOptions.isPending} onSelect={chooseModel} /> + + {text.length.toLocaleString("en-US")} /{" "} + {ASSISTANT_MESSAGE_MAX_CHARACTERS.toLocaleString("en-US")} characters + { expect(harness.browserErrors).toEqual([]) }) +test("aligns the composer with the server query limit", async ({ page }) => { + const harness = await assistantHarness(page) + await page.goto("/") + + const composer = page.getByPlaceholder("Ask OrgMemory…") + await expect(composer).toHaveAttribute("maxlength", "1000") + await expect(composer).toHaveAttribute( + "aria-describedby", + "assistant-message-length", + ) + const maximumMessage = "a".repeat(1_000) + await composer.fill(maximumMessage) + const counter = page.getByText("1,000 / 1,000 characters") + await expect(counter).toBeVisible() + await expect(counter).toHaveAttribute("id", "assistant-message-length") + await composer.press("a") + await expect(composer).toHaveValue(maximumMessage) + expect(harness.chatBodies).toEqual([]) + expect(harness.unexpectedRequests).toEqual([]) +}) + test("loads server-owned starters and restores a session-scoped draft with focus", async ({ page }) => { const harness = await assistantHarness(page) await page.goto("/") diff --git a/contracts/openapi.json b/contracts/openapi.json index 3937bfee..486c9ddc 100644 --- a/contracts/openapi.json +++ b/contracts/openapi.json @@ -1 +1 @@ -{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"v0"},"servers":[{"url":"http://localhost"}],"paths":{"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/pack/{itemKey}":{"put":{"tags":["assistant-asset-tool-controller"],"summary":"Update actor-derived Pack progress after explicit confirmation","operationId":"updateAssistantPackProgress","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"itemKey","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackProgressRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PackToolResult"}}}}}}},"/api/assistant/messages/{messageId}/feedback":{"put":{"tags":["assistant-controller"],"summary":"Create or replace feedback on an owned Assistant answer","operationId":"setAssistantAnswerFeedback","parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerFeedbackRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssistantAnswerFeedbackView"}}}}}},"delete":{"tags":["assistant-controller"],"summary":"Remove feedback from an owned Assistant answer","operationId":"deleteAssistantAnswerFeedback","parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}}},"/api/assistant/conversations/{conversationId}/model":{"put":{"tags":["assistant-controller"],"summary":"Select one allowed model for an owned Assistant conversation","operationId":"selectAssistantConversationModel","parameters":[{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelectAssistantModelRequest"}}},"required":true},"responses":{"204":{"description":"No Content"}}}},"/api/assets/{assetId}/skill-draft":{"put":{"tags":["asset-registry-controller"],"summary":"Replace the package of one mutable Skill draft","operationId":"replaceSkillDraftPackage","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"expectedLockVersion","in":"query","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/pack-progress/{itemKey}":{"put":{"tags":["asset-consumption-controller"],"summary":"Idempotently update actor-derived progress for one accessible Pack item","operationId":"setCapabilityPackProgress","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"itemKey","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackProgressRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PackJourney"}}}}}}},"/api/assets/{assetId}/draft":{"put":{"tags":["asset-registry-controller"],"summary":"Update a mutable Asset draft","operationId":"updateAssetDraft","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAssetDraftRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/admin/source-principals/{principalId}/mapping":{"put":{"tags":["admin-source-access-controller"],"summary":"Confirm a principal maps to an internal user","operationId":"confirmAdminSourceMapping","parameters":[{"name":"principalId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmMappingRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminSourcePrincipalResponse"}}}}}},"delete":{"tags":["admin-source-access-controller"],"summary":"Revoke a principal's active mapping","operationId":"revokeAdminSourceMapping","parameters":[{"name":"principalId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminSourcePrincipalResponse"}}}}}}},"/api/admin/source-connections/identity-trust":{"put":{"tags":["admin-source-access-controller"],"summary":"Record the identity trust for a connection","operationId":"setAdminSourceConnectionTrust","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityTrustRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminSourceConnectionResponse"}}}}}}},"/api/admin/connectors/{sourceSystem}/{connectionKey}":{"put":{"tags":["admin-connector-controller"],"summary":"Record how a connection is crawled","operationId":"configureAdminConnection","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}},{"name":"connectionKey","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfigureConnectionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminConnectionResponse"}}}}}}},"/api/admin/connectors/{sourceSystem}/{connectionKey}/credential":{"put":{"tags":["admin-connector-controller"],"summary":"Store a credential for a connection","operationId":"setAdminConnectionCredential","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}},{"name":"connectionKey","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectorCredentialRequest"}}},"required":true},"responses":{"204":{"description":"No Content"}}},"delete":{"tags":["admin-connector-controller"],"summary":"Forget a connection's stored credential","operationId":"forgetAdminConnectionCredential","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}},{"name":"connectionKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"No Content"}}}},"/api/admin/ai/routes/{workload}":{"put":{"tags":["admin-ai-model-controller"],"summary":"Set an editable organization AI route","operationId":"setAdminAiRoute","parameters":[{"name":"workload","in":"path","required":true,"schema":{"type":"string","enum":["ASSISTANT_CHAT","PROMPT_EXECUTION","KEYWORD_PLANNING","GRAPH_EXTRACTION","QUERY_EMBEDDING","DOCUMENT_EMBEDDING"]}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetRouteRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RouteResponse"}}}}}},"delete":{"tags":["admin-ai-model-controller"],"summary":"Restore the deployment default for an editable AI route","operationId":"clearAdminAiRoute","parameters":[{"name":"workload","in":"path","required":true,"schema":{"type":"string","enum":["ASSISTANT_CHAT","PROMPT_EXECUTION","KEYWORD_PLANNING","GRAPH_EXTRACTION","QUERY_EMBEDDING","DOCUMENT_EMBEDDING"]}}],"responses":{"204":{"description":"No Content"}}}},"/api/admin/ai/gateways/{profileId}":{"put":{"tags":["admin-ai-model-controller"],"summary":"Update an organization AI gateway","operationId":"updateAdminAiGateway","parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateGatewayRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GatewayResponse"}}}}}},"delete":{"tags":["admin-ai-model-controller"],"summary":"Disable an unused organization AI gateway","operationId":"disableAdminAiGateway","parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}}},"/api/admin/ai/gateways/{profileId}/credential":{"put":{"tags":["admin-ai-model-controller"],"summary":"Set or rotate an organization AI gateway credential","operationId":"setAdminAiGatewayCredential","parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayCredentialRequest"}}},"required":true},"responses":{"204":{"description":"No Content"}}}},"/api/admin/ai/gateways/{profileId}/assistant-models":{"put":{"tags":["admin-ai-model-controller"],"summary":"Replace additional chat models allowed on the active Assistant gateway","operationId":"replaceAdminAssistantModels","parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssistantModelsRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssistantModelResponse"}}}}}}}},"/api/sources":{"get":{"tags":["source-controller"],"summary":"List sources visible to the current user","operationId":"listSources","parameters":[{"name":"knowledgeSpaceId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"classification","in":"query","required":false,"schema":{"type":"string","enum":["PUBLIC","INTERNAL","CONFIDENTIAL","RESTRICTED"]}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["PROCESSING","READY","ATTENTION"]}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":25}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SourcePageResponse"}}}}}},"post":{"tags":["source-controller"],"summary":"Upload a source for asynchronous ingestion","operationId":"uploadSource","parameters":[{"name":"classification","in":"query","required":false,"schema":{"type":"string","default":"CONFIDENTIAL","enum":["PUBLIC","INTERNAL","CONFIDENTIAL","RESTRICTED"]}},{"name":"knowledgeSpaceId","in":"query","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}}}}},"/api/knowledge-spaces/{knowledgeSpaceId}/graph/curations/suppressions":{"post":{"tags":["knowledge-graph-management-controller"],"summary":"Delete an effective graph identity without deleting evidence","operationId":"suppressGraphIdentity","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuppressIdentityRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"oneOf":[{"$ref":"#/components/schemas/CuratedEntity"},{"$ref":"#/components/schemas/CuratedRelation"},{"$ref":"#/components/schemas/IdentityAlias"},{"$ref":"#/components/schemas/IdentitySuppression"}]}}}}}}},"/api/knowledge-spaces/{knowledgeSpaceId}/graph/curations/relations":{"post":{"tags":["knowledge-graph-management-controller"],"summary":"Create or edit a governed graph relation","operationId":"curateGraphRelation","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurateRelationRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"oneOf":[{"$ref":"#/components/schemas/CuratedEntity"},{"$ref":"#/components/schemas/CuratedRelation"},{"$ref":"#/components/schemas/IdentityAlias"},{"$ref":"#/components/schemas/IdentitySuppression"}]}}}}}}},"/api/knowledge-spaces/{knowledgeSpaceId}/graph/curations/entities":{"post":{"tags":["knowledge-graph-management-controller"],"summary":"Create or edit a governed graph entity","operationId":"curateGraphEntity","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurateEntityRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"oneOf":[{"$ref":"#/components/schemas/CuratedEntity"},{"$ref":"#/components/schemas/CuratedRelation"},{"$ref":"#/components/schemas/IdentityAlias"},{"$ref":"#/components/schemas/IdentitySuppression"}]}}}}}}},"/api/knowledge-spaces/{knowledgeSpaceId}/graph/curations/aliases":{"post":{"tags":["knowledge-graph-management-controller"],"summary":"Merge graph identities through a reversible alias","operationId":"mergeGraphIdentity","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AliasIdentityRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"oneOf":[{"$ref":"#/components/schemas/CuratedEntity"},{"$ref":"#/components/schemas/CuratedRelation"},{"$ref":"#/components/schemas/IdentityAlias"},{"$ref":"#/components/schemas/IdentitySuppression"}]}}}}}}},"/api/knowledge-assets/{knowledgeAssetId}/graph-index":{"post":{"tags":["knowledge-asset-lifecycle-controller"],"summary":"Ensure graph indexing uses the current processing profile","operationId":"ensureKnowledgeAssetGraphIndex","parameters":[{"name":"knowledgeAssetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"202":{"description":"Accepted","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GraphIndexJobView"}}}}}}},"/api/knowledge-assets/graph-jobs/{jobId}/resume":{"post":{"tags":["knowledge-asset-lifecycle-controller"],"summary":"Resume unfinished graph indexing","operationId":"resumeGraphIndexJob","parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"202":{"description":"Accepted","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GraphIndexJobView"}}}}}}},"/api/knowledge-assets/graph-jobs/{jobId}/cancel":{"post":{"tags":["knowledge-asset-lifecycle-controller"],"summary":"Cancel queued or in-flight graph indexing","operationId":"cancelGraphIndexJob","parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GraphIndexJobView"}}}}}}},"/api/assistant/tools/knowledge-search":{"post":{"tags":["assistant-asset-tool-controller"],"summary":"Search canonical permission-aware Knowledge and return citation references","operationId":"searchAssistantKnowledge","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeSearchRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/KnowledgeResult"}}}}}}},"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/prompt-run":{"post":{"tags":["assistant-asset-tool-controller"],"summary":"Run an exact Prompt release after explicit external-provider confirmation","operationId":"runAssistantPrompt","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptRunRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptRunToolResult"}}}}}}},"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/prompt-render":{"post":{"tags":["assistant-asset-tool-controller"],"summary":"Render an exact Prompt release after variable validation","operationId":"renderAssistantPrompt","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptRenderRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptRenderToolResult"}}}}}}},"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/pack":{"get":{"tags":["assistant-asset-tool-controller"],"summary":"Read an actor-scoped exact Pack journey","operationId":"readAssistantPack","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PackToolResult"}}}}}},"post":{"tags":["assistant-asset-tool-controller"],"summary":"Start an exact Pack after explicit state-change confirmation","operationId":"startAssistantPack","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedActionRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PackToolResult"}}}}}}},"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/fork":{"post":{"tags":["assistant-asset-tool-controller"],"summary":"Fork an exact release after explicit draft-creation confirmation","operationId":"forkAssistantAssetRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForkRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ForkResult"}}}}}}},"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/feedback":{"post":{"tags":["assistant-asset-tool-controller"],"summary":"Submit feedback against an exact release after explicit confirmation","operationId":"submitAssistantAssetFeedback","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/FeedbackResult"}}}}}}},"/api/assistant/chat":{"post":{"tags":["assistant-controller"],"summary":"Stream an answer from permission-verified knowledge","operationId":"streamAssistantChat","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssistantChatRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"text/event-stream":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ServerSentEventString"}}}}}}}},"/api/assets":{"get":{"tags":["asset-registry-controller"],"summary":"List released or authoring Assets visible to the actor","operationId":"listAssets","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssetSummary"}}}}}}},"post":{"tags":["asset-registry-controller"],"summary":"Create an Asset and its mutable draft","operationId":"createAsset","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAssetRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/submissions":{"post":{"tags":["asset-registry-controller"],"summary":"Submit an immutable Asset revision for review","operationId":"submitAssetRevision","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitAssetRevisionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/skill-releases":{"post":{"tags":["asset-registry-controller"],"summary":"Publish a Skill draft as an immutable release","operationId":"publishSkillRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishSkillReleaseRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/role-assignments":{"post":{"tags":["asset-registry-controller"],"summary":"Assign an accountable role on an Asset","operationId":"assignAssetRole","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignAssetRoleRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/reviews/{reviewCaseId}/decisions":{"post":{"tags":["asset-registry-controller"],"summary":"Record a decision against an exact revision digest","operationId":"decideAssetReview","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"reviewCaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetReviewDecisionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/releases":{"post":{"tags":["asset-registry-controller"],"summary":"Publish an approved immutable Asset revision","operationId":"publishAssetRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishAssetReleaseRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/work-instruction/acknowledgement":{"post":{"tags":["asset-consumption-controller"],"summary":"Idempotently acknowledge an exact Work Instruction release","operationId":"acknowledgeWorkInstruction","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WorkInstructionView"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/withdrawal":{"post":{"tags":["asset-registry-controller"],"summary":"Withdraw an Asset release from new use","operationId":"withdrawAssetRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetAvailabilityRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/prompt/runs":{"post":{"tags":["asset-consumption-controller"],"summary":"Run an exact Prompt release through the provider-neutral AI gateway","operationId":"runPromptRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptRunRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptRunResult"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/prompt/render":{"post":{"tags":["asset-consumption-controller"],"summary":"Deterministically render an exact authorized Prompt release","operationId":"renderPromptRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptVariablesRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptRenderResult"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/prompt/evaluations":{"post":{"tags":["asset-consumption-controller"],"summary":"Run the bounded evaluation cases pinned in a Prompt release","operationId":"evaluatePromptRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptEvaluationResult"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/pack-assignment":{"post":{"tags":["asset-consumption-controller"],"summary":"Start or resume an exact authorized Capability Pack release","operationId":"startCapabilityPack","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PackJourney"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/forks":{"post":{"tags":["asset-consumption-controller"],"summary":"Fork an exact authorized release into a new mutable draft","operationId":"forkAssetRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForkReleaseRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/deprecation":{"post":{"tags":["asset-registry-controller"],"summary":"Deprecate an Asset release","operationId":"deprecateAssetRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetAvailabilityRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/prompt/evaluation-comparisons":{"post":{"tags":["asset-consumption-controller"],"summary":"Compare bounded evaluation results for two exact Prompt releases","operationId":"comparePromptReleases","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptComparisonRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptEvaluationComparison"}}}}}}},"/api/assets/skills":{"post":{"tags":["asset-registry-controller"],"summary":"Validate and import one Agent Skill package","operationId":"importSkillPackage","parameters":[{"name":"namespace","in":"query","required":true,"schema":{"type":"string"}},{"name":"knowledgeSpaceId","in":"query","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"classification","in":"query","required":false,"schema":{"type":"string","default":"INTERNAL","enum":["PUBLIC","INTERNAL","CONFIDENTIAL","RESTRICTED"]}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/skills/inspections":{"post":{"tags":["asset-registry-controller"],"summary":"Validate and inspect one Agent Skill package without storing it","operationId":"inspectSkillPackage","requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SkillPackageInspection"}}}}}}},"/api/assets/skills/github/preview":{"post":{"tags":["asset-registry-controller"],"summary":"Discover and validate Skills at one GitHub repository revision","operationId":"previewGitHubSkills","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GitHubSkillSourceRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Preview"}}}}}}},"/api/assets/skills/github/import":{"post":{"tags":["asset-registry-controller"],"summary":"Import selected Skills from an exact GitHub commit","operationId":"importGitHubSkills","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GitHubSkillImportRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ImportResult"}}}}}}},"/api/asset-delivery/{assetId}/releases/{releaseId}/prompt-render":{"post":{"tags":["asset-delivery-controller"],"summary":"Deterministically render an exact authorized Prompt release","operationId":"renderReleasedPrompt","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptVariablesRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptRenderResult"}}}}}}},"/api/admin/roles/{role}/members":{"post":{"tags":["admin-role-controller"],"summary":"Assign a user to a role","operationId":"assignAdminRole","parameters":[{"name":"role","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignRoleRequest"}}},"required":true},"responses":{"204":{"description":"No Content"}}}},"/api/admin/provisioning/connections":{"get":{"tags":["admin-provisioning-controller"],"summary":"List SCIM provisioning connections","operationId":"listProvisioningConnections","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ConnectionResponse"}}}}}}},"post":{"tags":["admin-provisioning-controller"],"summary":"Create a disabled SCIM connection","operationId":"createProvisioningConnection","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConnectionRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ConnectionResponse"}}}}}}},"/api/admin/provisioning/connections/{connectionId}/credentials":{"get":{"tags":["admin-provisioning-controller"],"summary":"List SCIM credential metadata","operationId":"listProvisioningCredentials","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CredentialResponse"}}}}}}},"post":{"tags":["admin-provisioning-controller"],"summary":"Issue a one-time SCIM credential","operationId":"issueProvisioningCredential","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueCredentialRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/IssuedCredentialResponse"}}}}}}},"/api/admin/provisioning/connections/{connectionId}/credentials/{credentialId}/rotate":{"post":{"tags":["admin-provisioning-controller"],"summary":"Rotate a SCIM credential with bounded overlap","operationId":"rotateProvisioningCredential","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"credentialId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueCredentialRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/IssuedCredentialResponse"}}}}}}},"/api/admin/knowledge-spaces":{"get":{"tags":["admin-knowledge-space-controller"],"summary":"List Knowledge Spaces and the grants stored against them","operationId":"listAdminKnowledgeSpaces","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminKnowledgeSpaceResponse"}}}}}}},"post":{"tags":["admin-knowledge-space-controller"],"summary":"Create a Knowledge Space","operationId":"createAdminKnowledgeSpace","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateKnowledgeSpaceRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminKnowledgeSpaceResponse"}}}}}}},"/api/admin/knowledge-spaces/{knowledgeSpaceId}/grants":{"post":{"tags":["admin-knowledge-space-controller"],"summary":"Grant a subject access to a Knowledge Space","operationId":"grantAdminKnowledgeSpaceAccess","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantKnowledgeSpaceAccessRequest"}}},"required":true},"responses":{"204":{"description":"No Content"}}},"delete":{"tags":["admin-knowledge-space-controller"],"summary":"Revoke a subject's access to a Knowledge Space","operationId":"revokeAdminKnowledgeSpaceAccess","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"relation","in":"query","required":true,"schema":{"type":"string"}},{"name":"kind","in":"query","required":true,"schema":{"type":"string","enum":["ORGANIZATION","DEPARTMENT","DEPARTMENT_MANAGERS","ROLE","USER"]}},{"name":"subjectId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"role","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"No Content"}}}},"/api/admin/invitations":{"get":{"tags":["admin-invitation-controller"],"summary":"List invited addresses and their status","operationId":"listAdminInvitations","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminInvitationResponse"}}}}}}},"post":{"tags":["admin-invitation-controller"],"summary":"Expect an address to sign in","operationId":"createAdminInvitation","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInvitationRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminInvitationResponse"}}}}}}},"/api/admin/connectors/{sourceSystem}/{connectionKey}/test":{"post":{"tags":["admin-connector-controller"],"summary":"Check a connection's stored credential","operationId":"testAdminConnection","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}},{"name":"connectionKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminConnectorProbeResponse"}}}}}}},"/api/admin/connectors/{sourceSystem}/{connectionKey}/crawl":{"post":{"tags":["admin-connector-controller"],"summary":"Ask for a content crawl on the next poll","operationId":"requestAdminConnectionCrawl","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}},{"name":"connectionKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"Accepted"}}}},"/api/admin/connectors/{sourceSystem}/test":{"post":{"tags":["admin-connector-controller"],"summary":"Check a credential without storing it","operationId":"testAdminConnectorCredential","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectorCredentialRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminConnectorProbeResponse"}}}}}}},"/api/admin/ai/gateways":{"get":{"tags":["admin-ai-model-controller"],"summary":"List organization AI gateway profiles","operationId":"listAdminAiGateways","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GatewayResponse"}}}}}}},"post":{"tags":["admin-ai-model-controller"],"summary":"Connect an organization AI gateway","operationId":"createAdminAiGateway","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateGatewayRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GatewayResponse"}}}}}}},"/api/admin/ai/gateways/{profileId}/test":{"post":{"tags":["admin-ai-model-controller"],"summary":"Test a stored organization AI gateway","operationId":"testStoredAdminAiGateway","parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProbeResponse"}}}}}}},"/api/admin/ai/gateways/test":{"post":{"tags":["admin-ai-model-controller"],"summary":"Test an AI gateway credential without storing it","operationId":"testAdminAiGateway","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestGatewayRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProbeResponse"}}}}}}},"/api/admin/access/explain":{"post":{"tags":["admin-permission-controller"],"summary":"Answer whether a user holds a permission on one resource, and by which derivation","operationId":"explainAdminAccess","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExplainAccessRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExplainAccessResponse"}}}}}}},"/api/assistant/conversations/{conversationId}":{"delete":{"tags":["assistant-controller"],"summary":"Delete the current actor's conversation transcript","operationId":"deleteAssistantConversation","parameters":[{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}},"patch":{"tags":["assistant-controller"],"summary":"Rename the current actor's conversation","operationId":"renameAssistantConversation","parameters":[{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenameConversationRequest"}}},"required":true},"responses":{"204":{"description":"No Content"}}}},"/api/admin/users/{userId}":{"patch":{"tags":["admin-user-controller"],"summary":"Change a user's clearance, department, or activation","operationId":"updateAdminUser","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAdminUserRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminUserResponse"}}}}}}},"/api/admin/provisioning/connections/{connectionId}/state":{"patch":{"tags":["admin-provisioning-controller"],"summary":"Compare-and-set SCIM connection state","operationId":"updateProvisioningConnectionState","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateStateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ConnectionResponse"}}}}}}},"/api/sources/{sourceId}/content":{"get":{"tags":["source-content-controller"],"summary":"Stream permission-verified current source evidence","operationId":"readSourceContent","parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StreamingResponseBody"}}}}}}},"/api/session":{"get":{"tags":["browser-session-controller"],"summary":"Read the current browser session","operationId":"getBrowserSession","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}}}}},"/api/session/csrf":{"get":{"tags":["browser-session-controller"],"summary":"Issue a CSRF token for browser mutations","operationId":"getBrowserCsrfToken","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CsrfResponse"}}}}}}},"/api/organization/context":{"get":{"tags":["organization-context-controller"],"operationId":"context","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrganizationContextResponse"}}}}}}},"/api/me":{"get":{"tags":["me-controller"],"summary":"Read the current user's governed profile","operationId":"getMe","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}}}}},"/api/knowledge/search":{"get":{"tags":["knowledge-search-controller"],"summary":"Search permission-verified knowledge evidence","operationId":"searchKnowledge","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/KnowledgeSearchResponse"}}}}}}},"/api/knowledge/catalog":{"get":{"tags":["knowledge-catalog-controller"],"summary":"List current permission-verified Knowledge versions for composition","operationId":"listKnowledgeCatalog","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeCatalogItem"}}}}}}}},"/api/knowledge-spaces/{knowledgeSpaceId}/graph/export":{"get":{"tags":["knowledge-graph-management-controller"],"summary":"Export only graph evidence visible to the current user","operationId":"exportKnowledgeGraph","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"JSON","enum":["JSON","CSV","MARKDOWN","TEXT"]}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"string"}}}}}}},"/api/knowledge-spaces/{knowledgeSpaceId}/graph/explorer":{"get":{"tags":["knowledge-graph-explorer-controller"],"summary":"Read a bounded permission-filtered graph view","operationId":"exploreKnowledgeGraph","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"entityLimit","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"maxDepth","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/KnowledgeGraphView"}}}}}}},"/api/knowledge-spaces/visible":{"get":{"tags":["knowledge-space-controller"],"summary":"List Knowledge Spaces visible to the current user","operationId":"listVisibleKnowledgeSpaces","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeSpaceResponse"}}}}}}}},"/api/knowledge-spaces/upload-targets":{"get":{"tags":["knowledge-space-controller"],"summary":"List Knowledge Spaces where the current user may add knowledge","operationId":"listKnowledgeSpaceUploadTargets","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeSpaceResponse"}}}}}}}},"/api/knowledge-assets/graph-jobs/{jobId}":{"get":{"tags":["knowledge-asset-lifecycle-controller"],"summary":"Read graph indexing lifecycle status","operationId":"getGraphIndexJob","parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GraphIndexJobView"}}}}}}},"/api/health":{"get":{"tags":["health-controller"],"operationId":"health","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}}}},"/api/citations/{chunkId}/excerpt":{"get":{"tags":["citation-content-controller"],"summary":"Read a bounded permission-verified citation excerpt","operationId":"readCitationExcerpt","parameters":[{"name":"chunkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CitationEvidenceExcerpt"}}}}}}},"/api/citations/{chunkId}/content":{"get":{"tags":["citation-content-controller"],"summary":"Stream permission-verified source evidence","operationId":"readCitationContent","parameters":[{"name":"chunkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StreamingResponseBody"}}}}}}},"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/work-instruction":{"get":{"tags":["assistant-asset-tool-controller"],"summary":"Guide an exact Work Instruction release","operationId":"followAssistantWorkInstruction","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WorkInstructionToolResult"}}}}}}},"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/prompt-form":{"get":{"tags":["assistant-asset-tool-controller"],"summary":"Resolve the variables required by an exact Prompt release","operationId":"prepareAssistantPrompt","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptFormResult"}}}}}}},"/api/assistant/tools/asset-recommendations":{"get":{"tags":["assistant-asset-tool-controller"],"summary":"Recommend exact usable Asset releases without leaking denied candidates","operationId":"recommendAssistantAssets","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RecommendationResult"}}}}}}},"/api/assistant/starters":{"get":{"tags":["assistant-controller"],"summary":"List supported prompts for starting an Assistant conversation","operationId":"listAssistantStarters","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssistantStarterPrompt"}}}}}}}},"/api/assistant/model-options":{"get":{"tags":["assistant-controller"],"summary":"List server-governed Assistant model choices for the current route","operationId":"getAssistantModelOptions","parameters":[{"name":"conversationId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssistantModelOptionsResponse"}}}}}}},"/api/assistant/messages/{messageId}/citations":{"get":{"tags":["assistant-controller"],"summary":"Hydrate currently authorized citations for one owned Assistant answer","operationId":"getAssistantMessageCitations","parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssistantCitationResponse"}}}}}}}},"/api/assistant/conversations":{"get":{"tags":["assistant-controller"],"summary":"List the current actor's conversations by recent activity","operationId":"listAssistantConversations","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssistantConversationSummary"}}}}}}}},"/api/assistant/conversations/{conversationId}/messages":{"get":{"tags":["assistant-controller"],"summary":"Replay a tenant- and actor-scoped full conversation transcript","operationId":"getAssistantConversationHistory","parameters":[{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssistantConversationMessageView"}}}}}}}},"/api/assets/{assetId}":{"get":{"tags":["asset-registry-controller"],"summary":"Read an authorized Asset and its governance history","operationId":"getAsset","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/work-instruction":{"get":{"tags":["asset-consumption-controller"],"summary":"Follow an exact authorized Work Instruction release","operationId":"followWorkInstruction","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WorkInstructionView"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/skill-manifest":{"get":{"tags":["asset-consumption-controller"],"summary":"Read the browser install contract for one exact authorized Skill release","operationId":"getSkillInstallContract","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SkillInstallManifest"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/pack-journey":{"get":{"tags":["asset-consumption-controller"],"summary":"Read an actor-scoped Capability Pack journey","operationId":"getCapabilityPackJourney","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PackJourney"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/pack-definition":{"get":{"tags":["asset-consumption-controller"],"summary":"Read the ordered authorized items pinned by a Capability Pack release","operationId":"getCapabilityPackDefinition","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CapabilityPackDefinition"}}}}}}},"/api/assets/{assetId}/governance-actions":{"get":{"tags":["asset-registry-controller"],"summary":"Read the current actor's available Governance actions","operationId":"getAssetGovernanceActions","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetGovernanceActions"}}}}}}},"/api/assets/skills/github/connections":{"get":{"tags":["asset-registry-controller"],"summary":"List approved GitHub connections available for private Skill import","operationId":"listGitHubSkillConnections","parameters":[{"name":"knowledgeSpaceId","in":"query","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ConnectionOption"}}}}}}}},"/api/assets/owned":{"get":{"tags":["asset-registry-controller"],"summary":"List Assets currently owned by the actor","operationId":"listOwnedAssets","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"RECENTLY_UPDATED","enum":["RECENTLY_UPDATED","NAME"]}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":24}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetSummaryPage"}}}}}}},"/api/assets/catalog":{"get":{"tags":["asset-consumption-controller"],"summary":"List exact usable Asset releases authorized for the current actor","operationId":"listAssetCatalog","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"RECENTLY_RELEASED","enum":["RECENTLY_RELEASED","NAME"]}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":24}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetRecommendationPage"}}}}}}},"/api/asset-delivery":{"get":{"tags":["asset-delivery-controller"],"summary":"Search exact released Assets authorized for the current actor","operationId":"searchReleasedAssets","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssetRecommendation"}}}}}}}},"/api/asset-delivery/{assetId}":{"get":{"tags":["asset-delivery-controller"],"summary":"Read the latest usable immutable release for an Asset","operationId":"getLatestReleasedAsset","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetDeliveryRelease"}}}}}}},"/api/asset-delivery/{assetId}/releases/{releaseId}":{"get":{"tags":["asset-delivery-controller"],"summary":"Read one exact usable immutable Asset release","operationId":"getReleasedAsset","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetDeliveryRelease"}}}}}}},"/api/asset-delivery/{assetId}/releases/{releaseId}/skill-package":{"get":{"tags":["asset-delivery-controller"],"summary":"Stream the verified package for one exact usable Skill release","operationId":"downloadReleasedSkillPackage","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StreamingResponseBody"}}}}}}},"/api/asset-delivery/{assetId}/releases/{releaseId}/skill-manifest":{"get":{"tags":["asset-delivery-controller"],"summary":"Read the install manifest for one exact usable Skill release","operationId":"getReleasedSkillManifest","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SkillInstallManifest"}}}}}}},"/api/asset-delivery/{assetId}/releases/{releaseId}/relations":{"get":{"tags":["asset-delivery-controller"],"summary":"Resolve only independently authorized relations of an exact release","operationId":"resolveReleasedAssetRelations","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetRelationResolution"}}}}}}},"/api/asset-delivery/{assetId}/releases/{releaseId}/pack":{"get":{"tags":["asset-delivery-controller"],"summary":"Read a Pack definition with independently authorized pinned items","operationId":"getReleasedCapabilityPack","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CapabilityPackDefinition"}}}}}}},"/api/asset-delivery/skills/{namespace}/{slug}/versions/{version}/manifest":{"get":{"tags":["asset-delivery-controller"],"summary":"Resolve an exact usable Skill release by coordinate and version","operationId":"resolveReleasedSkillManifest","parameters":[{"name":"namespace","in":"path","required":true,"schema":{"type":"string"}},{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SkillInstallManifest"}}}}}}},"/api/admin/users":{"get":{"tags":["admin-user-controller"],"summary":"List internal users with their sign-in and mapping status","operationId":"listAdminUsers","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminUserResponse"}}}}}}}},"/api/admin/users/{userId}/permissions":{"get":{"tags":["admin-permission-controller"],"summary":"Resolve a user's organization permissions as the engine currently answers them","operationId":"listAdminUserPermissions","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EffectivePermissionResponse"}}}}}}},"/api/admin/source-principals":{"get":{"tags":["admin-source-access-controller"],"summary":"List observed principals and their mapping","operationId":"listAdminSourcePrincipals","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminSourcePrincipalResponse"}}}}}}}},"/api/admin/source-groups":{"get":{"tags":["admin-source-access-controller"],"summary":"List source groups with their sealed membership","operationId":"listAdminSourceGroups","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminSourceGroupResponse"}}}}}}}},"/api/admin/source-connections":{"get":{"tags":["admin-source-access-controller"],"summary":"List observed connections and their trust level","operationId":"listAdminSourceConnections","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminSourceConnectionResponse"}}}}}}}},"/api/admin/roles":{"get":{"tags":["admin-role-controller"],"summary":"List roles and who is assigned to them","operationId":"listAdminRoles","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminRoleListResponse"}}}}}}},"/api/admin/knowledge-spaces/grant-options":{"get":{"tags":["admin-knowledge-space-controller"],"summary":"List the subject shapes each Knowledge Space relation accepts","operationId":"listAdminKnowledgeSpaceGrantOptions","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeSpaceGrantOptionResponse"}}}}}}}},"/api/admin/connectors/{sourceSystem}":{"get":{"tags":["admin-connector-controller"],"summary":"List a source's connections and their crawl settings","operationId":"listAdminConnections","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminConnectionResponse"}}}}}}}},"/api/admin/connectors/{sourceSystem}/{connectionKey}/scopes":{"get":{"tags":["admin-connector-controller"],"summary":"List what a connection can be pointed at","operationId":"listAdminConnectionScopes","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}},{"name":"connectionKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminConnectorScopeResponse"}}}}}}}},"/api/admin/connectors/{sourceSystem}/{connectionKey}/activity":{"get":{"tags":["admin-connector-controller"],"summary":"Read what a connection has crawled and what went wrong","operationId":"getAdminConnectionActivity","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}},{"name":"connectionKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminConnectionActivityResponse"}}}}}}},"/api/admin/connectors/sources":{"get":{"tags":["admin-connector-controller"],"summary":"List the sources this deployment can ingest","operationId":"listAdminConnectorSources","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminConnectorSourceResponse"}}}}}}}},"/api/admin/ai/routes":{"get":{"tags":["admin-ai-model-controller"],"summary":"List effective organization AI routes","operationId":"listAdminAiRoutes","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RouteResponse"}}}}}}}},"/api/admin/ai/providers":{"get":{"tags":["admin-ai-model-controller"],"summary":"List provider presets implemented by this deployment","operationId":"listAdminAiProviderPresets","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProviderPresetResponse"}}}}}}}},"/api/admin/ai/index-settings":{"get":{"tags":["admin-ai-model-controller"],"summary":"Read immutable deployment-managed embedding settings","operationId":"getAdminAiIndexSettings","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/IndexSettingsResponse"}}}}}}},"/api/sources/{sourceId}":{"delete":{"tags":["source-controller"],"summary":"Retire a ready manual-upload document","operationId":"deleteSource","parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/KnowledgeAssetRef"}}}}}}},"/api/knowledge-spaces/{knowledgeSpaceId}/graph/curations/{curationId}":{"delete":{"tags":["knowledge-graph-management-controller"],"summary":"Reverse a graph curation record","operationId":"deactivateGraphCuration","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"curationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"authorizationGeneration","in":"query","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"reason","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/knowledge-assets/{knowledgeAssetId}":{"delete":{"tags":["knowledge-asset-lifecycle-controller"],"summary":"Retire a Knowledge Asset and remove its derived graph","operationId":"deleteKnowledgeAsset","parameters":[{"name":"knowledgeAssetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/KnowledgeAssetRef"}}}}}}},"/api/admin/roles/{role}/members/{userId}":{"delete":{"tags":["admin-role-controller"],"summary":"Remove a user from a role","operationId":"revokeAdminRole","parameters":[{"name":"role","in":"path","required":true,"schema":{"type":"string"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}}},"/api/admin/provisioning/connections/{connectionId}/credentials/{credentialId}":{"delete":{"tags":["admin-provisioning-controller"],"summary":"Immediately revoke a SCIM credential","operationId":"revokeProvisioningCredential","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"credentialId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}}},"/api/admin/invitations/{invitationId}":{"delete":{"tags":["admin-invitation-controller"],"summary":"Withdraw an invitation that has not been used","operationId":"revokeAdminInvitation","parameters":[{"name":"invitationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}}}},"components":{"schemas":{"PackProgressRequest":{"type":"object","properties":{"completed":{"type":"boolean"},"confirmed":{"type":"boolean"}}},"Item":{"type":"object","properties":{"key":{"type":"string"},"required":{"type":"boolean"},"order":{"type":"integer","format":"int32"},"kind":{"type":"string"},"resourceId":{"type":"string","format":"uuid"},"pinnedVersionId":{"type":"string","format":"uuid"},"title":{"type":"string"},"versionLabel":{"type":"string"},"availability":{"type":"string","enum":["AVAILABLE","DEPRECATED","WITHDRAWN"]},"completed":{"type":"boolean"},"completedAt":{"type":"string","format":"date-time"}}},"PackJourney":{"type":"object","properties":{"assignmentId":{"type":"string","format":"uuid"},"packAssetId":{"type":"string","format":"uuid"},"packReleaseId":{"type":"string","format":"uuid"},"releaseDigest":{"type":"string"},"title":{"type":"string"},"versionLabel":{"type":"string"},"purpose":{"type":"string","enum":["ROLE_ONBOARDING","HANDOVER","ROLE_ENABLEMENT"]},"audience":{"type":"string"},"expectedOutcome":{"type":"string"},"status":{"type":"string","enum":["IN_PROGRESS","COMPLETED"]},"accessGap":{"type":"boolean"},"completedAccessibleItems":{"type":"integer","format":"int32"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Item"}},"startedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"}}},"PackToolResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"journey":{"$ref":"#/components/schemas/PackJourney"}}},"AnswerFeedbackRequest":{"type":"object","properties":{"sentiment":{"type":"string","enum":["HELPFUL","NOT_HELPFUL"]}},"required":["sentiment"]},"AssistantAnswerFeedbackView":{"type":"object","properties":{"messageId":{"type":"string","format":"uuid"},"sentiment":{"type":"string","enum":["HELPFUL","NOT_HELPFUL"]},"updatedAt":{"type":"string","format":"date-time"}}},"SelectAssistantModelRequest":{"type":"object","properties":{"modelActivationId":{"type":"string","format":"uuid"}}},"AssetView":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]},"namespace":{"type":"string"},"slug":{"type":"string"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"portfolioState":{"type":"string","enum":["DRAFT_ONLY","ACTIVE","SUNSETTING","RETIRED"]},"authorizationReady":{"type":"boolean"},"draft":{"$ref":"#/components/schemas/Draft"},"revisions":{"type":"array","items":{"$ref":"#/components/schemas/Revision"}},"reviews":{"type":"array","items":{"$ref":"#/components/schemas/Review"}},"releases":{"type":"array","items":{"$ref":"#/components/schemas/Release"}},"ownershipHealth":{"$ref":"#/components/schemas/OwnershipHealth"},"roleAssignments":{"type":"array","items":{"$ref":"#/components/schemas/RoleAssignment"}}}},"AvailabilityEvent":{"type":"object","properties":{"availability":{"type":"string","enum":["AVAILABLE","DEPRECATED","WITHDRAWN"]},"reason":{"type":"string"},"changedByUserId":{"type":"string","format":"uuid"},"effectiveAt":{"type":"string","format":"date-time"}}},"Decision":{"type":"object","properties":{"reviewerUserId":{"type":"string","format":"uuid"},"decision":{"type":"string","enum":["REQUEST_CHANGES","REJECT","APPROVE","CANCEL"]},"comment":{"type":"string"},"decidedAt":{"type":"string","format":"date-time"}}},"Draft":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"lockVersion":{"type":"integer","format":"int64"},"title":{"type":"string"},"summary":{"type":"string"},"classification":{"type":"string"},"schemaVersion":{"type":"string"},"payload":{"type":"string"},"editedByUserId":{"type":"string","format":"uuid"},"updatedAt":{"type":"string","format":"date-time"}}},"OwnershipHealth":{"type":"object","properties":{"ownerPresent":{"type":"boolean"},"backupOwnerPresent":{"type":"boolean"},"orphaned":{"type":"boolean"},"continuityAtRisk":{"type":"boolean"}}},"Release":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"revisionId":{"type":"string","format":"uuid"},"sequence":{"type":"integer","format":"int64"},"versionLabel":{"type":"string"},"publicationMode":{"type":"string","enum":["REVIEWED","DIRECT"]},"title":{"type":"string"},"summary":{"type":"string"},"classification":{"type":"string"},"schemaVersion":{"type":"string"},"payload":{"type":"string"},"digest":{"type":"string"},"releasedByUserId":{"type":"string","format":"uuid"},"releasedAt":{"type":"string","format":"date-time"},"availability":{"type":"string","enum":["AVAILABLE","DEPRECATED","WITHDRAWN"]},"availabilityHistory":{"type":"array","items":{"$ref":"#/components/schemas/AvailabilityEvent"}}}},"Review":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"revisionId":{"type":"string","format":"uuid"},"revisionDigest":{"type":"string"},"state":{"type":"string","enum":["IN_REVIEW","CHANGES_REQUESTED","REJECTED","CANCELLED","APPROVED"]},"policyVersion":{"type":"string"},"requestedByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"resolvedAt":{"type":"string","format":"date-time"},"decisions":{"type":"array","items":{"$ref":"#/components/schemas/Decision"}}}},"Revision":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"sequence":{"type":"integer","format":"int64"},"title":{"type":"string"},"summary":{"type":"string"},"classification":{"type":"string"},"schemaVersion":{"type":"string"},"payload":{"type":"string"},"digest":{"type":"string"},"changeNote":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"}}},"RoleAssignment":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"principalType":{"type":"string"},"principalId":{"type":"string"},"role":{"type":"string","enum":["OWNER","BACKUP_OWNER","STEWARD","VIEWER","EDITOR","REVIEWER","PUBLISHER"]},"validFrom":{"type":"string","format":"date-time"},"validUntil":{"type":"string","format":"date-time"},"assignedByUserId":{"type":"string","format":"uuid"},"projectedAt":{"type":"string","format":"date-time"}}},"UpdateAssetDraftRequest":{"type":"object","properties":{"expectedLockVersion":{"type":"integer","format":"int64"},"title":{"type":"string"},"summary":{"type":"string"},"classification":{"type":"string"},"schemaVersion":{"type":"string"},"payload":{"type":"string"}}},"ConfirmMappingRequest":{"type":"object","properties":{"appUserId":{"type":"string","format":"uuid"}}},"AdminSourceMappingResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"appUserId":{"type":"string","format":"uuid"},"appUserName":{"type":"string"},"appUserEmail":{"type":"string"},"method":{"type":"string","enum":["IDP_JOIN","SSO_EMAIL_JOIN","SELF_CLAIM","ADMIN_CONFIRMED"]},"status":{"type":"string","enum":["ACTIVE","REVOKED"]},"evidence":{"type":"string"},"verifiedAt":{"type":"string","format":"date-time"}}},"AdminSourcePrincipalResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"sourceSystem":{"type":"string"},"sourceConnectionKey":{"type":"string"},"nativePrincipalId":{"type":"string"},"kind":{"type":"string","enum":["SOURCE_USER","SOURCE_GROUP"]},"observedEmail":{"type":"string"},"observedDisplayName":{"type":"string"},"ssoVerified":{"type":"boolean"},"lastSeenAt":{"type":"string","format":"date-time"},"mapping":{"$ref":"#/components/schemas/AdminSourceMappingResponse"}}},"IdentityTrustRequest":{"type":"object","properties":{"sourceSystem":{"type":"string"},"sourceConnectionKey":{"type":"string"},"identityTrust":{"type":"string","enum":["UNTRUSTED","SSO_VERIFIED"]}}},"AdminSourceConnectionResponse":{"type":"object","properties":{"sourceSystem":{"type":"string"},"sourceConnectionKey":{"type":"string"},"identityTrust":{"type":"string","enum":["UNTRUSTED","SSO_VERIFIED"]},"trustDecidedByUserId":{"type":"string","format":"uuid"},"trustDecidedAt":{"type":"string","format":"date-time"},"userCount":{"type":"integer","format":"int32"},"mappedUserCount":{"type":"integer","format":"int32"},"unmappedUserCount":{"type":"integer","format":"int32"},"groupCount":{"type":"integer","format":"int32"},"lastSeenAt":{"type":"string","format":"date-time"}}},"ConfigureConnectionRequest":{"type":"object","properties":{"crawlEnabled":{"type":"boolean"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"actorUserId":{"type":"string","format":"uuid"},"sourceConfig":{"type":"object","additionalProperties":{}},"contentCrawlIntervalSeconds":{"type":"integer","format":"int64"}}},"AdminConnectionResponse":{"type":"object","properties":{"sourceSystem":{"type":"string"},"sourceConnectionKey":{"type":"string"},"identityTrust":{"type":"string","enum":["UNTRUSTED","SSO_VERIFIED"]},"crawlEnabled":{"type":"boolean"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"actorUserId":{"type":"string","format":"uuid"},"sourceConfig":{"type":"object","additionalProperties":{}},"contentCrawlIntervalSeconds":{"type":"integer","format":"int64"},"credentialSet":{"type":"boolean"},"credentialSetByUserId":{"type":"string","format":"uuid"},"credentialSetAt":{"type":"string","format":"date-time"},"configuredByUserId":{"type":"string","format":"uuid"},"configuredAt":{"type":"string","format":"date-time"}}},"ConnectorCredentialRequest":{"type":"object","properties":{"credential":{"type":"string"}}},"SetRouteRequest":{"type":"object","properties":{"gatewayProfileId":{"type":"string","format":"uuid"},"modelId":{"type":"string"},"openAiReasoningEffort":{"type":"string","enum":["NONE","LOW","MEDIUM","HIGH","XHIGH","MAX"]}}},"RouteResponse":{"type":"object","properties":{"workload":{"type":"string","enum":["ASSISTANT_CHAT","PROMPT_EXECUTION","KEYWORD_PLANNING","GRAPH_EXTRACTION","QUERY_EMBEDDING","DOCUMENT_EMBEDDING"]},"gatewayKey":{"type":"string"},"gatewayProfileId":{"type":"string","format":"uuid"},"modelId":{"type":"string"},"openAiReasoningEffort":{"type":"string","enum":["NONE","LOW","MEDIUM","HIGH","XHIGH","MAX"]},"source":{"type":"string"},"editable":{"type":"boolean"},"version":{"type":"integer","format":"int64"},"lifecycleNote":{"type":"string"}}},"UpdateGatewayRequest":{"type":"object","properties":{"displayName":{"type":"string"},"baseUrl":{"type":"string"},"requestTimeoutSeconds":{"type":"integer","format":"int32"},"supportsOpenAiReasoningEffort":{"type":"boolean"},"credential":{"type":"string"}}},"AssistantModelResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"modelId":{"type":"string"},"displayName":{"type":"string"}}},"GatewayResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"gatewayKey":{"type":"string"},"displayName":{"type":"string"},"preset":{"type":"string","enum":["OPENAI","ANTHROPIC","NINE_ROUTER","OPENROUTER","LITELLM","OLLAMA","OPENAI_COMPATIBLE"]},"category":{"type":"string","enum":["DIRECT_PROVIDER","GATEWAY_ROUTER","SELF_HOSTED_CUSTOM"]},"protocol":{"type":"string","enum":["OPENAI_COMPATIBLE","ANTHROPIC_MESSAGES"]},"supportsOpenAiReasoningEffort":{"type":"boolean"},"baseUrl":{"type":"string"},"requestTimeoutSeconds":{"type":"integer","format":"int32"},"enabled":{"type":"boolean"},"version":{"type":"integer","format":"int64"},"credentialSet":{"type":"boolean"},"credentialSetByUserId":{"type":"string","format":"uuid"},"credentialSetAt":{"type":"string","format":"date-time"},"assistantModels":{"type":"array","items":{"$ref":"#/components/schemas/AssistantModelResponse"}}}},"GatewayCredentialRequest":{"type":"object","properties":{"credential":{"type":"string"}}},"AssistantModelDefinitionRequest":{"type":"object","properties":{"modelId":{"type":"string"},"displayName":{"type":"string"}}},"AssistantModelsRequest":{"type":"object","properties":{"models":{"type":"array","items":{"$ref":"#/components/schemas/AssistantModelDefinitionRequest"}}}},"SourceResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"sourceSystem":{"type":"string"},"aclAuthority":{"type":"string"},"status":{"type":"string"},"classification":{"type":"string"},"fileName":{"type":"string"},"mediaType":{"type":"string"},"contentLength":{"type":"integer","format":"int64"},"failureCode":{"type":"string"},"failureMessage":{"type":"string"},"knowledgeAssetId":{"type":"string","format":"uuid"},"knowledgeSpaceKey":{"type":"string"},"knowledgeSpaceName":{"type":"string"},"owningDepartmentName":{"type":"string"},"uploadedByName":{"type":"string"},"publicationComplete":{"type":"boolean"},"contentAvailable":{"type":"boolean"},"deletionAllowed":{"type":"boolean"},"embeddingProfileKey":{"type":"string"},"embeddingProvider":{"type":"string"},"embeddingModel":{"type":"string"},"embeddingDimensions":{"type":"integer","format":"int32"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"SuppressIdentityRequest":{"type":"object","properties":{"idempotencyKey":{"type":"string"},"reason":{"type":"string"},"authorizationGeneration":{"type":"integer","format":"int64"},"kind":{"type":"string","enum":["ENTITY","RELATION"]},"identityId":{"type":"string","format":"uuid"}}},"CuratedEntity":{"allOf":[{"$ref":"#/components/schemas/GraphCurationRecord"},{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"namespace":{"$ref":"#/components/schemas/ProjectionNamespace"},"entity":{"$ref":"#/components/schemas/GraphIdentityRef"},"name":{"type":"string"},"type":{"type":"string"},"description":{"type":"string"},"governingEvidence":{"$ref":"#/components/schemas/EvidenceReference"},"provenance":{"$ref":"#/components/schemas/CurationProvenance"}}}]},"CuratedRelation":{"allOf":[{"$ref":"#/components/schemas/GraphCurationRecord"},{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"namespace":{"$ref":"#/components/schemas/ProjectionNamespace"},"relation":{"$ref":"#/components/schemas/GraphIdentityRef"},"sourceEntity":{"$ref":"#/components/schemas/GraphIdentityRef"},"targetEntity":{"$ref":"#/components/schemas/GraphIdentityRef"},"type":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"weight":{"type":"number","format":"double"},"governingEvidence":{"$ref":"#/components/schemas/EvidenceReference"},"provenance":{"$ref":"#/components/schemas/CurationProvenance"}}}]},"CurationProvenance":{"type":"object","properties":{"actorUserId":{"type":"string","format":"uuid"},"authorizationModelId":{"type":"string"},"aclGeneration":{"type":"integer","format":"int64"},"curatedAt":{"type":"string","format":"date-time"},"reason":{"type":"string"}}},"EvidenceReference":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid"},"knowledgeAssetId":{"type":"string","format":"uuid"},"sourceRevisionId":{"type":"string","format":"uuid"},"chunkId":{"type":"string","format":"uuid"},"aclSnapshotId":{"type":"string","format":"uuid"},"aclGeneration":{"type":"integer","format":"int64"},"chunk":{"type":"boolean"}}},"GraphCurationRecord":{},"GraphIdentityRef":{"type":"object","properties":{"kind":{"type":"string","enum":["ENTITY","RELATION"]},"id":{"type":"string","format":"uuid"}}},"IdentityAlias":{"allOf":[{"$ref":"#/components/schemas/GraphCurationRecord"},{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"namespace":{"$ref":"#/components/schemas/ProjectionNamespace"},"source":{"$ref":"#/components/schemas/GraphIdentityRef"},"target":{"$ref":"#/components/schemas/GraphIdentityRef"},"provenance":{"$ref":"#/components/schemas/CurationProvenance"}}}]},"IdentitySuppression":{"allOf":[{"$ref":"#/components/schemas/GraphCurationRecord"},{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"namespace":{"$ref":"#/components/schemas/ProjectionNamespace"},"identity":{"$ref":"#/components/schemas/GraphIdentityRef"},"provenance":{"$ref":"#/components/schemas/CurationProvenance"}}}]},"ProjectionNamespace":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid"},"workspace":{"type":"string"},"collection":{"type":"string"}}},"CurateRelationRequest":{"type":"object","properties":{"idempotencyKey":{"type":"string"},"reason":{"type":"string"},"authorizationGeneration":{"type":"integer","format":"int64"},"relationId":{"type":"string","format":"uuid"},"sourceEntityId":{"type":"string","format":"uuid"},"targetEntityId":{"type":"string","format":"uuid"},"type":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"weight":{"type":"number","format":"double"},"evidence":{"$ref":"#/components/schemas/EvidenceRequest"}}},"EvidenceRequest":{"type":"object","properties":{"knowledgeAssetId":{"type":"string","format":"uuid"},"sourceRevisionId":{"type":"string","format":"uuid"},"chunkId":{"type":"string","format":"uuid"},"aclSnapshotId":{"type":"string","format":"uuid"},"aclGeneration":{"type":"integer","format":"int64"}}},"CurateEntityRequest":{"type":"object","properties":{"idempotencyKey":{"type":"string"},"reason":{"type":"string"},"authorizationGeneration":{"type":"integer","format":"int64"},"entityId":{"type":"string","format":"uuid"},"name":{"type":"string"},"type":{"type":"string"},"description":{"type":"string"},"evidence":{"$ref":"#/components/schemas/EvidenceRequest"}}},"AliasIdentityRequest":{"type":"object","properties":{"idempotencyKey":{"type":"string"},"reason":{"type":"string"},"authorizationGeneration":{"type":"integer","format":"int64"},"kind":{"type":"string","enum":["ENTITY","RELATION"]},"sourceIdentityId":{"type":"string","format":"uuid"},"targetIdentityId":{"type":"string","format":"uuid"}}},"GraphIndexJobView":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"knowledgeAssetId":{"type":"string","format":"uuid"},"knowledgeAssetVersionId":{"type":"string","format":"uuid"},"sourceRevisionId":{"type":"string","format":"uuid"},"projectionGeneration":{"type":"integer","format":"int64"},"graphProcessingProfileId":{"type":"string","format":"uuid"},"graphProcessingProfileSha256":{"type":"string"},"status":{"type":"string"},"attempt":{"type":"integer","format":"int32"},"cancellationRequested":{"type":"boolean"},"cancellationRequestedAt":{"type":"string","format":"date-time"},"lastErrorCode":{"type":"string"},"lastErrorMessage":{"type":"string"},"completedAt":{"type":"string","format":"date-time"}}},"KnowledgeSearchRequest":{"type":"object","properties":{"query":{"type":"string"},"requestId":{"type":"string"}}},"KnowledgeCitation":{"type":"object","properties":{"chunkId":{"type":"string","format":"uuid"},"knowledgeAssetId":{"type":"string","format":"uuid"},"sourceRevisionId":{"type":"string","format":"uuid"},"title":{"type":"string"},"startPage":{"type":"integer","format":"int32"},"endPage":{"type":"integer","format":"int32"},"heading":{"type":"string"}}},"KnowledgeResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"requestId":{"type":"string"},"citations":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeCitation"}}}},"PromptRunRequest":{"type":"object","properties":{"variables":{"type":"object","additionalProperties":{}},"knowledgeQuery":{"type":"string"},"requestId":{"type":"string"},"confirmedExternalProvider":{"type":"boolean"}}},"AiRoute":{"type":"object","properties":{"gatewayId":{"type":"string"},"modelId":{"type":"string"},"openAiReasoningEffort":{"type":"string","enum":["NONE","LOW","MEDIUM","HIGH","XHIGH","MAX"]}}},"PromptCitation":{"type":"object","properties":{"chunkId":{"type":"string","format":"uuid"},"knowledgeAssetId":{"type":"string","format":"uuid"},"sourceRevisionId":{"type":"string","format":"uuid"},"title":{"type":"string"},"startPage":{"type":"integer","format":"int32"},"endPage":{"type":"integer","format":"int32"},"heading":{"type":"string"}}},"PromptRunResult":{"type":"object","properties":{"runId":{"type":"string","format":"uuid"},"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"releaseDigest":{"type":"string"},"modelRoute":{"$ref":"#/components/schemas/AiRoute"},"output":{"type":"string"},"citations":{"type":"array","items":{"$ref":"#/components/schemas/PromptCitation"}},"durationMillis":{"type":"integer","format":"int64"}}},"PromptRunToolResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"result":{"$ref":"#/components/schemas/PromptRunResult"}}},"PromptRenderRequest":{"type":"object","properties":{"variables":{"type":"object","additionalProperties":{}}}},"PromptRenderResult":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"releaseDigest":{"type":"string"},"systemInstruction":{"type":"string"},"userPrompt":{"type":"string"},"sensitiveVariables":{"type":"array","items":{"type":"string"}},"inputShapeDigest":{"type":"string"}}},"PromptRenderToolResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"result":{"$ref":"#/components/schemas/PromptRenderResult"}}},"ConfirmedActionRequest":{"type":"object","properties":{"confirmed":{"type":"boolean"}}},"ForkRequest":{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"confirmed":{"type":"boolean"}}},"ForkResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"asset":{"$ref":"#/components/schemas/AssetView"}}},"FeedbackRequest":{"type":"object","properties":{"type":{"type":"string","enum":["HELPFUL","OUTDATED","INCORRECT","OTHER"]},"comment":{"type":"string"},"confirmed":{"type":"boolean"}}},"FeedbackResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"feedbackId":{"type":"string","format":"uuid"}}},"AssistantChatRequest":{"type":"object","properties":{"message":{"type":"string","maxLength":4000,"minLength":0},"limit":{"type":"integer","format":"int32"},"conversationId":{"type":"string","format":"uuid"},"modelActivationId":{"type":"string","format":"uuid"}},"required":["message"]},"ServerSentEventString":{},"AssetDraftRequest":{"type":"object","properties":{"title":{"type":"string"},"summary":{"type":"string"},"classification":{"type":"string"},"schemaVersion":{"type":"string"},"payload":{"type":"string"}}},"CreateAssetRequest":{"type":"object","properties":{"type":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK"]},"namespace":{"type":"string"},"slug":{"type":"string"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"draft":{"$ref":"#/components/schemas/AssetDraftRequest"}}},"SubmitAssetRevisionRequest":{"type":"object","properties":{"changeNote":{"type":"string"}}},"PublishSkillReleaseRequest":{"type":"object","properties":{"versionLabel":{"type":"string"}}},"AssignAssetRoleRequest":{"type":"object","properties":{"principalType":{"type":"string"},"principalId":{"type":"string"},"role":{"type":"string","enum":["OWNER","BACKUP_OWNER","STEWARD","VIEWER","EDITOR","REVIEWER","PUBLISHER"]}}},"AssetReviewDecisionRequest":{"type":"object","properties":{"decision":{"type":"string","enum":["REQUEST_CHANGES","REJECT","APPROVE","CANCEL"]},"comment":{"type":"string"}}},"PublishAssetReleaseRequest":{"type":"object","properties":{"revisionId":{"type":"string","format":"uuid"},"versionLabel":{"type":"string"}}},"Step":{"type":"object","properties":{"key":{"type":"string"},"title":{"type":"string"},"instruction":{"type":"string"},"expectedResult":{"type":"string"},"check":{"type":"string"},"escalation":{"type":"string"},"prohibitedActions":{"type":"array","items":{"type":"string"}},"relatedAssetIds":{"type":"array","items":{"type":"string","format":"uuid"}},"relatedKnowledgeVersionIds":{"type":"array","items":{"type":"string","format":"uuid"}}}},"WorkInstructionSpec":{"type":"object","properties":{"purpose":{"type":"string"},"audience":{"type":"string"},"prerequisites":{"type":"array","items":{"type":"string"}},"completionOutcome":{"type":"string"},"responsibleRole":{"type":"string"},"steps":{"type":"array","items":{"$ref":"#/components/schemas/Step"}}}},"WorkInstructionView":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"releaseDigest":{"type":"string"},"title":{"type":"string"},"versionLabel":{"type":"string"},"instruction":{"$ref":"#/components/schemas/WorkInstructionSpec"},"acknowledged":{"type":"boolean"},"acknowledgedAt":{"type":"string","format":"date-time"}}},"AssetAvailabilityRequest":{"type":"object","properties":{"reason":{"type":"string"}}},"PromptVariablesRequest":{"type":"object","properties":{"variables":{"type":"object","additionalProperties":{}}}},"CaseResult":{"type":"object","properties":{"name":{"type":"string"},"passed":{"type":"boolean"},"failedAssertions":{"type":"array","items":{"type":"string"}},"promptRunId":{"type":"string","format":"uuid"}}},"PromptEvaluationResult":{"type":"object","properties":{"evaluationId":{"type":"string","format":"uuid"},"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"releaseDigest":{"type":"string"},"passedCases":{"type":"integer","format":"int32"},"totalCases":{"type":"integer","format":"int32"},"cases":{"type":"array","items":{"$ref":"#/components/schemas/CaseResult"}}}},"ForkReleaseRequest":{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"},"knowledgeSpaceId":{"type":"string","format":"uuid"}}},"PromptComparisonRequest":{"type":"object","properties":{"baselineReleaseId":{"type":"string","format":"uuid"},"candidateReleaseId":{"type":"string","format":"uuid"}}},"PromptEvaluationComparison":{"type":"object","properties":{"baseline":{"$ref":"#/components/schemas/PromptEvaluationResult"},"candidate":{"$ref":"#/components/schemas/PromptEvaluationResult"},"passedCaseDelta":{"type":"integer","format":"int32"}}},"FileEntry":{"type":"object","properties":{"path":{"type":"string"},"size":{"type":"integer","format":"int64"},"sha256":{"type":"string"}}},"SkillPackageInspection":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"license":{"type":"string"},"compatibility":{"type":"string"},"allowedTools":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"instructions":{"type":"string"},"sha256":{"type":"string"},"contentLength":{"type":"integer","format":"int64"},"files":{"type":"array","items":{"$ref":"#/components/schemas/FileEntry"}}}},"GitHubSkillSourceRequest":{"type":"object","properties":{"repository":{"type":"string","maxLength":512,"minLength":0},"revision":{"type":"string"},"subpath":{"type":"string"},"connectionKey":{"type":"string"},"knowledgeSpaceId":{"type":"string","format":"uuid"}},"required":["knowledgeSpaceId","repository"]},"Preview":{"type":"object","properties":{"repository":{"type":"string"},"revision":{"type":"string"},"visibility":{"type":"string","enum":["PUBLIC","PRIVATE"]},"skills":{"type":"array","items":{"$ref":"#/components/schemas/PreviewItem"}}}},"PreviewItem":{"type":"object","properties":{"path":{"type":"string"},"importable":{"type":"boolean"},"name":{"type":"string"},"description":{"type":"string"},"fileCount":{"type":"integer","format":"int32"},"errorCode":{"type":"string"},"errorMessage":{"type":"string"}}},"GitHubSkillImportRequest":{"type":"object","properties":{"source":{"$ref":"#/components/schemas/GitHubSkillSourceRequest"},"paths":{"type":"array","items":{"type":"string","minLength":1},"maxItems":20,"minItems":1},"namespace":{"type":"string","maxLength":128,"minLength":0},"classification":{"type":"string","enum":["PUBLIC","INTERNAL","CONFIDENTIAL","RESTRICTED"]}},"required":["namespace","paths","source"]},"ImportItem":{"type":"object","properties":{"path":{"type":"string"},"imported":{"type":"boolean"},"asset":{"$ref":"#/components/schemas/AssetView"},"errorCode":{"type":"string"},"errorMessage":{"type":"string"}}},"ImportResult":{"type":"object","properties":{"repository":{"type":"string"},"revision":{"type":"string"},"visibility":{"type":"string","enum":["PUBLIC","PRIVATE"]},"skills":{"type":"array","items":{"$ref":"#/components/schemas/ImportItem"}}}},"AssignRoleRequest":{"type":"object","properties":{"userId":{"type":"string","format":"uuid"}}},"CreateConnectionRequest":{"type":"object","properties":{"alias":{"type":"string"},"providerProfile":{"type":"string","enum":["GENERIC_SCIM","MICROSOFT_ENTRA","OKTA"]}}},"ConnectionResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"alias":{"type":"string"},"providerProfile":{"type":"string","enum":["GENERIC_SCIM","MICROSOFT_ENTRA","OKTA"]},"configurationStatus":{"type":"string"},"operationalState":{"type":"string","enum":["DISABLED","VALIDATING","ENABLED","READ_ONLY","SUSPENDED"]},"usersEnabled":{"type":"boolean"},"groupsEnabled":{"type":"boolean"},"version":{"type":"integer","format":"int64"}}},"IssueCredentialRequest":{"type":"object","properties":{"usersScope":{"type":"boolean"},"groupsScope":{"type":"boolean"}}},"IssuedCredentialResponse":{"type":"object","properties":{"credentialId":{"type":"string","format":"uuid"},"token":{"type":"string"},"publicTokenId":{"type":"string"},"usersScope":{"type":"boolean"},"groupsScope":{"type":"boolean"},"expiresAt":{"type":"string","format":"date-time"}}},"CreateKnowledgeSpaceRequest":{"type":"object","properties":{"name":{"type":"string"},"audienceMode":{"type":"string","enum":["ORGANIZATION","DEPARTMENT","RESTRICTED_CUSTOM"]},"departmentId":{"type":"string","format":"uuid"}}},"AdminKnowledgeSpaceResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"key":{"type":"string"},"name":{"type":"string"},"audienceMode":{"type":"string","enum":["ORGANIZATION","DEPARTMENT","RESTRICTED_CUSTOM"]},"audienceVersion":{"type":"integer","format":"int64"},"departmentId":{"type":"string","format":"uuid"},"active":{"type":"boolean"},"grants":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeSpaceGrantResponse"}},"grantsComplete":{"type":"boolean"},"policyVersion":{"type":"string"}}},"KnowledgeSpaceGrantResponse":{"type":"object","properties":{"relation":{"type":"string"},"subject":{"type":"string"},"effective":{"type":"boolean"}}},"GrantKnowledgeSpaceAccessRequest":{"type":"object","properties":{"relation":{"type":"string"},"kind":{"type":"string","enum":["ORGANIZATION","DEPARTMENT","DEPARTMENT_MANAGERS","ROLE","USER"]},"subjectId":{"type":"string","format":"uuid"},"role":{"type":"string"}}},"CreateInvitationRequest":{"type":"object","properties":{"email":{"type":"string"},"clearance":{"type":"string","enum":["STANDARD","EXECUTIVE"]},"departmentId":{"type":"string","format":"uuid"}}},"AdminInvitationResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string"},"clearance":{"type":"string","enum":["STANDARD","EXECUTIVE"]},"departmentId":{"type":"string","format":"uuid"},"status":{"type":"string"},"invitedAt":{"type":"string","format":"date-time"},"acceptedAt":{"type":"string","format":"date-time"},"acceptedAppUserId":{"type":"string","format":"uuid"}}},"AdminConnectorProbeResponse":{"type":"object","properties":{"authenticated":{"type":"boolean"},"connectionKey":{"type":"string"},"accountName":{"type":"string"},"identityName":{"type":"string"},"canReadContent":{"type":"boolean"},"errorCode":{"type":"string"}}},"CreateGatewayRequest":{"type":"object","properties":{"gatewayKey":{"type":"string"},"displayName":{"type":"string"},"preset":{"type":"string","enum":["OPENAI","ANTHROPIC","NINE_ROUTER","OPENROUTER","LITELLM","OLLAMA","OPENAI_COMPATIBLE"]},"category":{"type":"string","enum":["DIRECT_PROVIDER","GATEWAY_ROUTER","SELF_HOSTED_CUSTOM"]},"protocol":{"type":"string","enum":["OPENAI_COMPATIBLE","ANTHROPIC_MESSAGES"]},"baseUrl":{"type":"string"},"requestTimeoutSeconds":{"type":"integer","format":"int32"},"supportsOpenAiReasoningEffort":{"type":"boolean"},"credential":{"type":"string"}}},"ModelRef":{"type":"object","properties":{"id":{"type":"string"},"displayName":{"type":"string"}}},"ProbeResponse":{"type":"object","properties":{"authenticated":{"type":"boolean"},"models":{"type":"array","items":{"$ref":"#/components/schemas/ModelRef"}},"errorCode":{"type":"string"}}},"TestGatewayRequest":{"type":"object","properties":{"preset":{"type":"string","enum":["OPENAI","ANTHROPIC","NINE_ROUTER","OPENROUTER","LITELLM","OLLAMA","OPENAI_COMPATIBLE"]},"protocol":{"type":"string","enum":["OPENAI_COMPATIBLE","ANTHROPIC_MESSAGES"]},"baseUrl":{"type":"string"},"requestTimeoutSeconds":{"type":"integer","format":"int32"},"credential":{"type":"string"}}},"ExplainAccessRequest":{"type":"object","properties":{"userId":{"type":"string","format":"uuid"},"permission":{"type":"string"},"resourceType":{"type":"string"},"resourceId":{"type":"string","format":"uuid"}}},"AccessBlockResponse":{"type":"object","properties":{"branch":{"type":"string"},"kind":{"type":"string"},"detail":{"type":"string"}}},"AccessStepResponse":{"type":"object","properties":{"object":{"type":"string"},"relation":{"type":"string"},"kind":{"type":"string"}}},"AclProvenanceResponse":{"type":"object","properties":{"authority":{"type":"string"},"origin":{"type":"string"},"generation":{"type":"integer","format":"int64"},"capturedAt":{"type":"string","format":"date-time"},"expired":{"type":"boolean"}}},"ExplainAccessResponse":{"type":"object","properties":{"state":{"type":"string","enum":["ALLOWED","DENIED","UNKNOWN"]},"reasonCode":{"type":"string"},"path":{"type":"array","items":{"$ref":"#/components/schemas/AccessStepResponse"}},"blockedBy":{"type":"array","items":{"$ref":"#/components/schemas/AccessBlockResponse"}},"provenance":{"$ref":"#/components/schemas/AclProvenanceResponse"},"evaluationKind":{"type":"string"},"relationshipState":{"type":"string","enum":["ALLOWED","DENIED","UNKNOWN"]},"relationshipReasonCode":{"type":"string"},"contentPolicyState":{"type":"string","enum":["ALLOWED","DENIED","UNKNOWN"]},"contentPolicyReasonCode":{"type":"string"},"resource":{"$ref":"#/components/schemas/ResourceSummaryResponse"},"policyVersion":{"type":"string"},"evaluatedAt":{"type":"string","format":"date-time"}}},"ResourceSummaryResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string"},"label":{"type":"string"},"contextLabel":{"type":"string"},"classification":{"type":"string"}}},"RenameConversationRequest":{"type":"object","properties":{"title":{"type":"string","maxLength":120,"minLength":0}},"required":["title"]},"UpdateAdminUserRequest":{"type":"object","properties":{"clearance":{"type":"string","enum":["STANDARD","EXECUTIVE"]},"active":{"type":"boolean"},"departmentId":{"type":["string","null"],"format":"uuid","description":"Omit to keep the current department; send null to clear it"}}},"AdminUserResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string"},"clearance":{"type":"string","enum":["STANDARD","EXECUTIVE"]},"departmentId":{"type":"string","format":"uuid"},"active":{"type":"boolean"},"signInLinked":{"type":"boolean"},"mappedPrincipalCount":{"type":"integer","format":"int32"}}},"UpdateStateRequest":{"type":"object","properties":{"expectedVersion":{"type":"integer","format":"int64"},"expectedState":{"type":"string","enum":["DISABLED","VALIDATING","ENABLED","READ_ONLY","SUSPENDED"]},"nextState":{"type":"string","enum":["DISABLED","VALIDATING","ENABLED","READ_ONLY","SUSPENDED"]}}},"SourcePageResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SourceResponse"}},"nextCursor":{"type":"string"},"pageSize":{"type":"integer","format":"int32"},"total":{"type":"integer","format":"int64"},"statusCounts":{"$ref":"#/components/schemas/SourceStatusCountsResponse"}}},"SourceStatusCountsResponse":{"type":"object","properties":{"processing":{"type":"integer","format":"int64"},"ready":{"type":"integer","format":"int64"},"attention":{"type":"integer","format":"int64"}}},"StreamingResponseBody":{},"SessionResponse":{"type":"object","properties":{"authenticated":{"type":"boolean"},"name":{"type":"string"},"email":{"type":"string"},"userId":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"departmentId":{"type":"string","format":"uuid"},"clearance":{"type":"string","enum":["STANDARD","EXECUTIVE"]},"canManageMembers":{"type":"boolean"}}},"CsrfResponse":{"type":"object","properties":{"headerName":{"type":"string"},"parameterName":{"type":"string"},"token":{"type":"string"}}},"DepartmentResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"OrganizationContextResponse":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid"},"departments":{"type":"array","items":{"$ref":"#/components/schemas/DepartmentResponse"}},"users":{"type":"array","items":{"$ref":"#/components/schemas/UserResponse"}}}},"UserResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"departmentId":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string"},"clearance":{"type":"string","enum":["STANDARD","EXECUTIVE"]}}},"MeResponse":{"type":"object","properties":{"userId":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string"},"departmentId":{"type":"string","format":"uuid"},"departmentName":{"type":"string"},"clearance":{"type":"string","enum":["STANDARD","EXECUTIVE"]}}},"KnowledgeEvidenceResponse":{"type":"object","properties":{"citationId":{"type":"string","format":"uuid"},"knowledgeAssetId":{"type":"string","format":"uuid"},"title":{"type":"string"},"content":{"type":"string"},"sourceUri":{"type":"string"},"startPage":{"type":"integer","format":"int32"},"endPage":{"type":"integer","format":"int32"},"heading":{"type":"string"},"relevanceScore":{"type":"number","format":"double"}}},"KnowledgeSearchResponse":{"type":"object","properties":{"requestId":{"type":"string"},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeEvidenceResponse"}}}},"KnowledgeCatalogItem":{"type":"object","properties":{"knowledgeAssetId":{"type":"string","format":"uuid"},"knowledgeVersionId":{"type":"string","format":"uuid"},"versionNumber":{"type":"integer","format":"int64"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"title":{"type":"string"},"language":{"type":"string"},"classification":{"type":"string","enum":["PUBLIC","INTERNAL","CONFIDENTIAL","RESTRICTED"]},"contentDigest":{"type":"string"}}},"Entity":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"type":{"type":"string"},"description":{"type":"string"},"citationChunkIds":{"type":"array","items":{"type":"string","format":"uuid"}},"governingEvidence":{"$ref":"#/components/schemas/EvidenceReference"}}},"KnowledgeGraphView":{"type":"object","properties":{"knowledgeSpaceId":{"type":"string","format":"uuid"},"authorizationGeneration":{"type":"integer","format":"int64"},"canCurate":{"type":"boolean"},"entities":{"type":"array","items":{"$ref":"#/components/schemas/Entity"}},"relations":{"type":"array","items":{"$ref":"#/components/schemas/Relation"}},"truncated":{"type":"boolean"}}},"Relation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"sourceEntityId":{"type":"string","format":"uuid"},"targetEntityId":{"type":"string","format":"uuid"},"type":{"type":"string"},"description":{"type":"string"},"weight":{"type":"number","format":"double"},"keywords":{"type":"array","items":{"type":"string"}},"citationChunkIds":{"type":"array","items":{"type":"string","format":"uuid"}},"governingEvidence":{"$ref":"#/components/schemas/EvidenceReference"}}},"KnowledgeSpaceResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"key":{"type":"string"},"name":{"type":"string"},"departmentId":{"type":"string","format":"uuid"}}},"CitationEvidenceExcerpt":{"type":"object","properties":{"title":{"type":"string"},"heading":{"type":"string"},"startPage":{"type":"integer","format":"int32"},"endPage":{"type":"integer","format":"int32"},"excerpt":{"type":"string"},"truncated":{"type":"boolean"},"presentationKind":{"type":"string","enum":["PDF","MARKDOWN","PLAIN_TEXT","IMAGE","DOWNLOAD"]}}},"WorkInstructionToolResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"instruction":{"$ref":"#/components/schemas/WorkInstructionView"}}},"AssistantReleaseRef":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"releaseDigest":{"type":"string"}}},"PromptFormResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"release":{"$ref":"#/components/schemas/AssistantReleaseRef"},"objective":{"type":"string"},"audience":{"type":"string"},"variables":{"type":"array","items":{"$ref":"#/components/schemas/Variable"}},"outputContract":{"type":"object","additionalProperties":{}},"knowledgeRequirements":{"type":"array","items":{"type":"string"}},"knownLimitations":{"type":"string"}}},"Variable":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["STRING","INTEGER","NUMBER","BOOLEAN","STRING_LIST"]},"required":{"type":"boolean"},"defaultValue":{},"sensitive":{"type":"boolean"},"pattern":{"type":"string"},"allowedValues":{"type":"array","items":{"type":"string"}}}},"AssetRecommendation":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]},"namespace":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"portfolioState":{"type":"string","enum":["DRAFT_ONLY","ACTIVE","SUNSETTING","RETIRED"]},"releaseId":{"type":"string","format":"uuid"},"versionLabel":{"type":"string"},"releaseDigest":{"type":"string"},"availability":{"type":"string","enum":["AVAILABLE","DEPRECATED","WITHDRAWN"]},"releasedAt":{"type":"string","format":"date-time"}}},"RecommendationResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/AssetRecommendation"}}}},"AssistantStarterPrompt":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"prompt":{"type":"string"}}},"AssistantModelOptionResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"gatewayLabel":{"type":"string"},"provider":{"type":"string"},"modelId":{"type":"string"},"displayName":{"type":"string"},"defaultChoice":{"type":"boolean"}}},"AssistantModelOptionsResponse":{"type":"object","properties":{"selectedModelActivationId":{"type":"string","format":"uuid"},"options":{"type":"array","items":{"$ref":"#/components/schemas/AssistantModelOptionResponse"}}}},"AssistantCitationResponse":{"type":"object","properties":{"citationNumber":{"type":"integer","format":"int32"},"sourceId":{"type":"string"},"title":{"type":"string"},"heading":{"type":"string"},"startPage":{"type":"integer","format":"int32"},"endPage":{"type":"integer","format":"int32"},"excerptUrl":{"type":"string"},"contentUrl":{"type":"string"}}},"AssistantConversationSummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"lastActivityAt":{"type":"string","format":"date-time"},"messageCount":{"type":"integer","format":"int64"}}},"AssistantConversationMessageView":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"role":{"type":"string","enum":["USER","ASSISTANT"]},"content":{"type":"string"},"sequence":{"type":"integer","format":"int64"},"occurredAt":{"type":"string","format":"date-time"},"feedback":{"type":"string","enum":["HELPFUL","NOT_HELPFUL"]}}},"AssetSummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]},"namespace":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"portfolioState":{"type":"string","enum":["DRAFT_ONLY","ACTIVE","SUNSETTING","RETIRED"]},"updatedAt":{"type":"string","format":"date-time"}}},"File":{"type":"object","properties":{"path":{"type":"string"},"size":{"type":"integer","format":"int64"},"sha256":{"type":"string"}}},"SkillInstallManifest":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"namespace":{"type":"string"},"slug":{"type":"string"},"coordinate":{"type":"string"},"version":{"type":"string"},"publicationMode":{"type":"string","enum":["REVIEWED","DIRECT"]},"title":{"type":"string"},"description":{"type":"string"},"releaseDigest":{"type":"string"},"packageDigest":{"type":"string"},"packageLength":{"type":"integer","format":"int64"},"mediaType":{"type":"string"},"license":{"type":"string"},"compatibility":{"type":"string"},"allowedTools":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"files":{"type":"array","items":{"$ref":"#/components/schemas/File"}}}},"CapabilityPackDefinition":{"type":"object","properties":{"packAssetId":{"type":"string","format":"uuid"},"packReleaseId":{"type":"string","format":"uuid"},"releaseDigest":{"type":"string"},"title":{"type":"string"},"versionLabel":{"type":"string"},"purpose":{"type":"string","enum":["ROLE_ONBOARDING","HANDOVER","ROLE_ENABLEMENT"]},"audience":{"type":"string"},"prerequisites":{"type":"array","items":{"type":"string"}},"expectedOutcome":{"type":"string"},"completionCriteria":{"type":"array","items":{"type":"string"}},"reviewDate":{"type":"string"},"owner":{"type":"string"},"accessGap":{"type":"boolean"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Item"}}}},"AssetGovernanceActions":{"type":"object","properties":{"canEdit":{"type":"boolean"},"canSubmitReview":{"type":"boolean"},"canReview":{"type":"boolean"},"canApprove":{"type":"boolean"},"canRequestChanges":{"type":"boolean"},"canReject":{"type":"boolean"},"canCancel":{"type":"boolean"},"canPublish":{"type":"boolean"},"canPublishSkill":{"type":"boolean"},"canWithdraw":{"type":"boolean"},"canOpenGovernance":{"type":"boolean"}}},"ConnectionOption":{"type":"object","properties":{"key":{"type":"string"}}},"AssetSummaryPage":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AssetSummary"}},"total":{"type":"integer","format":"int64"},"page":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"totalPages":{"type":"integer","format":"int32"},"sort":{"type":"string","enum":["RECENTLY_UPDATED","NAME"]}}},"AssetRecommendationPage":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AssetRecommendation"}},"total":{"type":"integer","format":"int64"},"page":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"totalPages":{"type":"integer","format":"int32"},"sort":{"type":"string","enum":["RECENTLY_RELEASED","NAME"]}}},"AssetDeliveryRelease":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]},"namespace":{"type":"string"},"slug":{"type":"string"},"versionLabel":{"type":"string"},"publicationMode":{"type":"string","enum":["REVIEWED","DIRECT"]},"title":{"type":"string"},"summary":{"type":"string"},"classification":{"type":"string"},"schemaVersion":{"type":"string"},"payload":{"type":"string"},"digest":{"type":"string"},"availability":{"type":"string","enum":["AVAILABLE","DEPRECATED","WITHDRAWN"]},"releasedAt":{"type":"string","format":"date-time"}}},"AssetRelationResolution":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"accessGap":{"type":"boolean"},"relations":{"type":"array","items":{"$ref":"#/components/schemas/Relation"}}}},"EffectivePermissionResponse":{"type":"object","properties":{"userId":{"type":"string","format":"uuid"},"permissions":{"type":"object","additionalProperties":{"type":"string","enum":["ALLOWED","DENIED","UNKNOWN"]}},"evaluatedAt":{"type":"string","format":"date-time"}}},"AdminSourceGroupMemberResponse":{"type":"object","properties":{"principalId":{"type":"string","format":"uuid"},"nativePrincipalId":{"type":"string"},"observedDisplayName":{"type":"string"},"observedEmail":{"type":"string"},"appUserId":{"type":"string","format":"uuid"},"appUserName":{"type":"string"}}},"AdminSourceGroupResponse":{"type":"object","properties":{"principalId":{"type":"string","format":"uuid"},"sourceSystem":{"type":"string"},"sourceConnectionKey":{"type":"string"},"nativePrincipalId":{"type":"string"},"observedDisplayName":{"type":"string"},"membershipSnapshotId":{"type":"string","format":"uuid"},"membershipGeneration":{"type":"integer","format":"int64"},"sealedAt":{"type":"string","format":"date-time"},"members":{"type":"array","items":{"$ref":"#/components/schemas/AdminSourceGroupMemberResponse"}}}},"AdminRoleListResponse":{"type":"object","properties":{"roles":{"type":"array","items":{"$ref":"#/components/schemas/AdminRoleResponse"}},"complete":{"type":"boolean"},"policyVersion":{"type":"string"}}},"AdminRoleResponse":{"type":"object","properties":{"role":{"type":"string"},"assignees":{"type":"array","items":{"type":"string"}}}},"CredentialResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"publicTokenId":{"type":"string"},"verifierKeyVersion":{"type":"integer","format":"int32"},"usersScope":{"type":"boolean"},"groupsScope":{"type":"boolean"},"expiresAt":{"type":"string","format":"date-time"},"overlapEndsAt":{"type":"string","format":"date-time"},"revokedAt":{"type":"string","format":"date-time"},"lastUsedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"}}},"KnowledgeSpaceGrantOptionResponse":{"type":"object","properties":{"relation":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["ORGANIZATION","DEPARTMENT","DEPARTMENT_MANAGERS","ROLE","USER"]}},"roles":{"type":"array","items":{"type":"string"}}}},"AdminConnectorScopeResponse":{"type":"object","properties":{"key":{"type":"string"},"displayName":{"type":"string"},"reachable":{"type":"boolean"},"admissible":{"type":"boolean"},"instruction":{"type":"string"}}},"AdminComponentCheckpointResponse":{"type":"object","properties":{"component":{"type":"string"},"observedCursor":{"type":"string"},"captureStatus":{"type":"string"},"incompleteReason":{"type":"string"},"observedAt":{"type":"string","format":"date-time"},"lastSuccessfulCursor":{"type":"string"},"lastSuccessfulAt":{"type":"string","format":"date-time"}}},"AdminConnectionActivityResponse":{"type":"object","properties":{"sourceSystem":{"type":"string"},"sourceConnectionKey":{"type":"string"},"objectsTotal":{"type":"integer","format":"int64"},"objectsActive":{"type":"integer","format":"int64"},"objectsArchived":{"type":"integer","format":"int64"},"lastObjectAt":{"type":"string","format":"date-time"},"lastCrawlAt":{"type":"string","format":"date-time"},"componentCheckpoints":{"type":"array","items":{"$ref":"#/components/schemas/AdminComponentCheckpointResponse"}},"recentAttempts":{"type":"array","items":{"$ref":"#/components/schemas/AdminCrawlAttemptResponse"}}}},"AdminCrawlAttemptResponse":{"type":"object","properties":{"outcome":{"type":"string"},"objectsMaterialized":{"type":"integer","format":"int32"},"objectsRotated":{"type":"integer","format":"int32"},"objectsRematerialized":{"type":"integer","format":"int32"},"objectsRetired":{"type":"integer","format":"int32"},"objectsFailed":{"type":"integer","format":"int32"},"errorCode":{"type":"string"},"errorMessage":{"type":"string"},"attemptedAt":{"type":"string","format":"date-time"}}},"AdminConnectorSourceResponse":{"type":"object","properties":{"sourceSystem":{"type":"string"},"displayName":{"type":"string"}}},"ProviderPresetResponse":{"type":"object","properties":{"preset":{"type":"string","enum":["OPENAI","ANTHROPIC","NINE_ROUTER","OPENROUTER","LITELLM","OLLAMA","OPENAI_COMPATIBLE"]},"displayName":{"type":"string"},"vendorName":{"type":"string"},"category":{"type":"string","enum":["DIRECT_PROVIDER","GATEWAY_ROUTER","SELF_HOSTED_CUSTOM"]},"protocol":{"type":"string","enum":["OPENAI_COMPATIBLE","ANTHROPIC_MESSAGES"]},"defaultBaseUrl":{"type":"string"},"baseUrlEditable":{"type":"boolean"}}},"IndexSettingsResponse":{"type":"object","properties":{"embeddingProvider":{"type":"string"},"embeddingModel":{"type":"string"},"dimensions":{"type":"integer","format":"int32"},"distanceMetric":{"type":"string"},"managementMode":{"type":"string"},"editable":{"type":"boolean"},"lifecycleNote":{"type":"string"}}},"KnowledgeAssetRef":{"type":"object","properties":{"knowledgeAssetId":{"type":"string","format":"uuid"},"knowledgeAssetVersionId":{"type":"string","format":"uuid"},"normalizedRecordId":{"type":"string","format":"uuid"},"rawSourceObjectId":{"type":"string","format":"uuid"},"sourceAclSnapshotId":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["PENDING","ACTIVE","RETIRED"]}}}}}} \ No newline at end of file +{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"v0"},"servers":[{"url":"http://localhost"}],"paths":{"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/pack/{itemKey}":{"put":{"tags":["assistant-asset-tool-controller"],"summary":"Update actor-derived Pack progress after explicit confirmation","operationId":"updateAssistantPackProgress","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"itemKey","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackProgressRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PackToolResult"}}}}}}},"/api/assistant/messages/{messageId}/feedback":{"put":{"tags":["assistant-controller"],"summary":"Create or replace feedback on an owned Assistant answer","operationId":"setAssistantAnswerFeedback","parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerFeedbackRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssistantAnswerFeedbackView"}}}}}},"delete":{"tags":["assistant-controller"],"summary":"Remove feedback from an owned Assistant answer","operationId":"deleteAssistantAnswerFeedback","parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}}},"/api/assistant/conversations/{conversationId}/model":{"put":{"tags":["assistant-controller"],"summary":"Select one allowed model for an owned Assistant conversation","operationId":"selectAssistantConversationModel","parameters":[{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelectAssistantModelRequest"}}},"required":true},"responses":{"204":{"description":"No Content"}}}},"/api/assets/{assetId}/skill-draft":{"put":{"tags":["asset-registry-controller"],"summary":"Replace the package of one mutable Skill draft","operationId":"replaceSkillDraftPackage","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"expectedLockVersion","in":"query","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/pack-progress/{itemKey}":{"put":{"tags":["asset-consumption-controller"],"summary":"Idempotently update actor-derived progress for one accessible Pack item","operationId":"setCapabilityPackProgress","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"itemKey","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackProgressRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PackJourney"}}}}}}},"/api/assets/{assetId}/draft":{"put":{"tags":["asset-registry-controller"],"summary":"Update a mutable Asset draft","operationId":"updateAssetDraft","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAssetDraftRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/admin/source-principals/{principalId}/mapping":{"put":{"tags":["admin-source-access-controller"],"summary":"Confirm a principal maps to an internal user","operationId":"confirmAdminSourceMapping","parameters":[{"name":"principalId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmMappingRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminSourcePrincipalResponse"}}}}}},"delete":{"tags":["admin-source-access-controller"],"summary":"Revoke a principal's active mapping","operationId":"revokeAdminSourceMapping","parameters":[{"name":"principalId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminSourcePrincipalResponse"}}}}}}},"/api/admin/source-connections/identity-trust":{"put":{"tags":["admin-source-access-controller"],"summary":"Record the identity trust for a connection","operationId":"setAdminSourceConnectionTrust","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdentityTrustRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminSourceConnectionResponse"}}}}}}},"/api/admin/connectors/{sourceSystem}/{connectionKey}":{"put":{"tags":["admin-connector-controller"],"summary":"Record how a connection is crawled","operationId":"configureAdminConnection","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}},{"name":"connectionKey","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfigureConnectionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminConnectionResponse"}}}}}}},"/api/admin/connectors/{sourceSystem}/{connectionKey}/credential":{"put":{"tags":["admin-connector-controller"],"summary":"Store a credential for a connection","operationId":"setAdminConnectionCredential","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}},{"name":"connectionKey","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectorCredentialRequest"}}},"required":true},"responses":{"204":{"description":"No Content"}}},"delete":{"tags":["admin-connector-controller"],"summary":"Forget a connection's stored credential","operationId":"forgetAdminConnectionCredential","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}},{"name":"connectionKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"No Content"}}}},"/api/admin/ai/routes/{workload}":{"put":{"tags":["admin-ai-model-controller"],"summary":"Set an editable organization AI route","operationId":"setAdminAiRoute","parameters":[{"name":"workload","in":"path","required":true,"schema":{"type":"string","enum":["ASSISTANT_CHAT","PROMPT_EXECUTION","KEYWORD_PLANNING","GRAPH_EXTRACTION","QUERY_EMBEDDING","DOCUMENT_EMBEDDING"]}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetRouteRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RouteResponse"}}}}}},"delete":{"tags":["admin-ai-model-controller"],"summary":"Restore the deployment default for an editable AI route","operationId":"clearAdminAiRoute","parameters":[{"name":"workload","in":"path","required":true,"schema":{"type":"string","enum":["ASSISTANT_CHAT","PROMPT_EXECUTION","KEYWORD_PLANNING","GRAPH_EXTRACTION","QUERY_EMBEDDING","DOCUMENT_EMBEDDING"]}}],"responses":{"204":{"description":"No Content"}}}},"/api/admin/ai/gateways/{profileId}":{"put":{"tags":["admin-ai-model-controller"],"summary":"Update an organization AI gateway","operationId":"updateAdminAiGateway","parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateGatewayRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GatewayResponse"}}}}}},"delete":{"tags":["admin-ai-model-controller"],"summary":"Disable an unused organization AI gateway","operationId":"disableAdminAiGateway","parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}}},"/api/admin/ai/gateways/{profileId}/credential":{"put":{"tags":["admin-ai-model-controller"],"summary":"Set or rotate an organization AI gateway credential","operationId":"setAdminAiGatewayCredential","parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayCredentialRequest"}}},"required":true},"responses":{"204":{"description":"No Content"}}}},"/api/admin/ai/gateways/{profileId}/assistant-models":{"put":{"tags":["admin-ai-model-controller"],"summary":"Replace additional chat models allowed on the active Assistant gateway","operationId":"replaceAdminAssistantModels","parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssistantModelsRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssistantModelResponse"}}}}}}}},"/api/sources":{"get":{"tags":["source-controller"],"summary":"List sources visible to the current user","operationId":"listSources","parameters":[{"name":"knowledgeSpaceId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"classification","in":"query","required":false,"schema":{"type":"string","enum":["PUBLIC","INTERNAL","CONFIDENTIAL","RESTRICTED"]}},{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["PROCESSING","READY","ATTENTION"]}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":25}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SourcePageResponse"}}}}}},"post":{"tags":["source-controller"],"summary":"Upload a source for asynchronous ingestion","operationId":"uploadSource","parameters":[{"name":"classification","in":"query","required":false,"schema":{"type":"string","default":"CONFIDENTIAL","enum":["PUBLIC","INTERNAL","CONFIDENTIAL","RESTRICTED"]}},{"name":"knowledgeSpaceId","in":"query","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SourceResponse"}}}}}}},"/api/knowledge-spaces/{knowledgeSpaceId}/graph/curations/suppressions":{"post":{"tags":["knowledge-graph-management-controller"],"summary":"Delete an effective graph identity without deleting evidence","operationId":"suppressGraphIdentity","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuppressIdentityRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"oneOf":[{"$ref":"#/components/schemas/CuratedEntity"},{"$ref":"#/components/schemas/CuratedRelation"},{"$ref":"#/components/schemas/IdentityAlias"},{"$ref":"#/components/schemas/IdentitySuppression"}]}}}}}}},"/api/knowledge-spaces/{knowledgeSpaceId}/graph/curations/relations":{"post":{"tags":["knowledge-graph-management-controller"],"summary":"Create or edit a governed graph relation","operationId":"curateGraphRelation","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurateRelationRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"oneOf":[{"$ref":"#/components/schemas/CuratedEntity"},{"$ref":"#/components/schemas/CuratedRelation"},{"$ref":"#/components/schemas/IdentityAlias"},{"$ref":"#/components/schemas/IdentitySuppression"}]}}}}}}},"/api/knowledge-spaces/{knowledgeSpaceId}/graph/curations/entities":{"post":{"tags":["knowledge-graph-management-controller"],"summary":"Create or edit a governed graph entity","operationId":"curateGraphEntity","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurateEntityRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"oneOf":[{"$ref":"#/components/schemas/CuratedEntity"},{"$ref":"#/components/schemas/CuratedRelation"},{"$ref":"#/components/schemas/IdentityAlias"},{"$ref":"#/components/schemas/IdentitySuppression"}]}}}}}}},"/api/knowledge-spaces/{knowledgeSpaceId}/graph/curations/aliases":{"post":{"tags":["knowledge-graph-management-controller"],"summary":"Merge graph identities through a reversible alias","operationId":"mergeGraphIdentity","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AliasIdentityRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"oneOf":[{"$ref":"#/components/schemas/CuratedEntity"},{"$ref":"#/components/schemas/CuratedRelation"},{"$ref":"#/components/schemas/IdentityAlias"},{"$ref":"#/components/schemas/IdentitySuppression"}]}}}}}}},"/api/knowledge-assets/{knowledgeAssetId}/graph-index":{"post":{"tags":["knowledge-asset-lifecycle-controller"],"summary":"Ensure graph indexing uses the current processing profile","operationId":"ensureKnowledgeAssetGraphIndex","parameters":[{"name":"knowledgeAssetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"202":{"description":"Accepted","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GraphIndexJobView"}}}}}}},"/api/knowledge-assets/graph-jobs/{jobId}/resume":{"post":{"tags":["knowledge-asset-lifecycle-controller"],"summary":"Resume unfinished graph indexing","operationId":"resumeGraphIndexJob","parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"202":{"description":"Accepted","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GraphIndexJobView"}}}}}}},"/api/knowledge-assets/graph-jobs/{jobId}/cancel":{"post":{"tags":["knowledge-asset-lifecycle-controller"],"summary":"Cancel queued or in-flight graph indexing","operationId":"cancelGraphIndexJob","parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GraphIndexJobView"}}}}}}},"/api/assistant/tools/knowledge-search":{"post":{"tags":["assistant-asset-tool-controller"],"summary":"Search canonical permission-aware Knowledge and return citation references","operationId":"searchAssistantKnowledge","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeSearchRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/KnowledgeResult"}}}}}}},"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/prompt-run":{"post":{"tags":["assistant-asset-tool-controller"],"summary":"Run an exact Prompt release after explicit external-provider confirmation","operationId":"runAssistantPrompt","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptRunRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptRunToolResult"}}}}}}},"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/prompt-render":{"post":{"tags":["assistant-asset-tool-controller"],"summary":"Render an exact Prompt release after variable validation","operationId":"renderAssistantPrompt","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptRenderRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptRenderToolResult"}}}}}}},"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/pack":{"get":{"tags":["assistant-asset-tool-controller"],"summary":"Read an actor-scoped exact Pack journey","operationId":"readAssistantPack","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PackToolResult"}}}}}},"post":{"tags":["assistant-asset-tool-controller"],"summary":"Start an exact Pack after explicit state-change confirmation","operationId":"startAssistantPack","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConfirmedActionRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PackToolResult"}}}}}}},"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/fork":{"post":{"tags":["assistant-asset-tool-controller"],"summary":"Fork an exact release after explicit draft-creation confirmation","operationId":"forkAssistantAssetRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForkRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ForkResult"}}}}}}},"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/feedback":{"post":{"tags":["assistant-asset-tool-controller"],"summary":"Submit feedback against an exact release after explicit confirmation","operationId":"submitAssistantAssetFeedback","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/FeedbackResult"}}}}}}},"/api/assistant/chat":{"post":{"tags":["assistant-controller"],"summary":"Stream an answer from permission-verified knowledge","operationId":"streamAssistantChat","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssistantChatRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"text/event-stream":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ServerSentEventString"}}}}}}}},"/api/assets":{"get":{"tags":["asset-registry-controller"],"summary":"List released or authoring Assets visible to the actor","operationId":"listAssets","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssetSummary"}}}}}}},"post":{"tags":["asset-registry-controller"],"summary":"Create an Asset and its mutable draft","operationId":"createAsset","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAssetRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/submissions":{"post":{"tags":["asset-registry-controller"],"summary":"Submit an immutable Asset revision for review","operationId":"submitAssetRevision","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitAssetRevisionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/skill-releases":{"post":{"tags":["asset-registry-controller"],"summary":"Publish a Skill draft as an immutable release","operationId":"publishSkillRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishSkillReleaseRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/role-assignments":{"post":{"tags":["asset-registry-controller"],"summary":"Assign an accountable role on an Asset","operationId":"assignAssetRole","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignAssetRoleRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/reviews/{reviewCaseId}/decisions":{"post":{"tags":["asset-registry-controller"],"summary":"Record a decision against an exact revision digest","operationId":"decideAssetReview","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"reviewCaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetReviewDecisionRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/releases":{"post":{"tags":["asset-registry-controller"],"summary":"Publish an approved immutable Asset revision","operationId":"publishAssetRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishAssetReleaseRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/work-instruction/acknowledgement":{"post":{"tags":["asset-consumption-controller"],"summary":"Idempotently acknowledge an exact Work Instruction release","operationId":"acknowledgeWorkInstruction","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WorkInstructionView"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/withdrawal":{"post":{"tags":["asset-registry-controller"],"summary":"Withdraw an Asset release from new use","operationId":"withdrawAssetRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetAvailabilityRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/prompt/runs":{"post":{"tags":["asset-consumption-controller"],"summary":"Run an exact Prompt release through the provider-neutral AI gateway","operationId":"runPromptRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptRunRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptRunResult"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/prompt/render":{"post":{"tags":["asset-consumption-controller"],"summary":"Deterministically render an exact authorized Prompt release","operationId":"renderPromptRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptVariablesRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptRenderResult"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/prompt/evaluations":{"post":{"tags":["asset-consumption-controller"],"summary":"Run the bounded evaluation cases pinned in a Prompt release","operationId":"evaluatePromptRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptEvaluationResult"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/pack-assignment":{"post":{"tags":["asset-consumption-controller"],"summary":"Start or resume an exact authorized Capability Pack release","operationId":"startCapabilityPack","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PackJourney"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/forks":{"post":{"tags":["asset-consumption-controller"],"summary":"Fork an exact authorized release into a new mutable draft","operationId":"forkAssetRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForkReleaseRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/deprecation":{"post":{"tags":["asset-registry-controller"],"summary":"Deprecate an Asset release","operationId":"deprecateAssetRelease","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssetAvailabilityRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/prompt/evaluation-comparisons":{"post":{"tags":["asset-consumption-controller"],"summary":"Compare bounded evaluation results for two exact Prompt releases","operationId":"comparePromptReleases","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptComparisonRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptEvaluationComparison"}}}}}}},"/api/assets/skills":{"post":{"tags":["asset-registry-controller"],"summary":"Validate and import one Agent Skill package","operationId":"importSkillPackage","parameters":[{"name":"namespace","in":"query","required":true,"schema":{"type":"string"}},{"name":"knowledgeSpaceId","in":"query","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"classification","in":"query","required":false,"schema":{"type":"string","default":"INTERNAL","enum":["PUBLIC","INTERNAL","CONFIDENTIAL","RESTRICTED"]}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/skills/inspections":{"post":{"tags":["asset-registry-controller"],"summary":"Validate and inspect one Agent Skill package without storing it","operationId":"inspectSkillPackage","requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SkillPackageInspection"}}}}}}},"/api/assets/skills/github/preview":{"post":{"tags":["asset-registry-controller"],"summary":"Discover and validate Skills at one GitHub repository revision","operationId":"previewGitHubSkills","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GitHubSkillSourceRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Preview"}}}}}}},"/api/assets/skills/github/import":{"post":{"tags":["asset-registry-controller"],"summary":"Import selected Skills from an exact GitHub commit","operationId":"importGitHubSkills","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GitHubSkillImportRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ImportResult"}}}}}}},"/api/asset-delivery/{assetId}/releases/{releaseId}/prompt-render":{"post":{"tags":["asset-delivery-controller"],"summary":"Deterministically render an exact authorized Prompt release","operationId":"renderReleasedPrompt","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromptVariablesRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptRenderResult"}}}}}}},"/api/admin/roles/{role}/members":{"post":{"tags":["admin-role-controller"],"summary":"Assign a user to a role","operationId":"assignAdminRole","parameters":[{"name":"role","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssignRoleRequest"}}},"required":true},"responses":{"204":{"description":"No Content"}}}},"/api/admin/provisioning/connections":{"get":{"tags":["admin-provisioning-controller"],"summary":"List SCIM provisioning connections","operationId":"listProvisioningConnections","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ConnectionResponse"}}}}}}},"post":{"tags":["admin-provisioning-controller"],"summary":"Create a disabled SCIM connection","operationId":"createProvisioningConnection","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConnectionRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ConnectionResponse"}}}}}}},"/api/admin/provisioning/connections/{connectionId}/credentials":{"get":{"tags":["admin-provisioning-controller"],"summary":"List SCIM credential metadata","operationId":"listProvisioningCredentials","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CredentialResponse"}}}}}}},"post":{"tags":["admin-provisioning-controller"],"summary":"Issue a one-time SCIM credential","operationId":"issueProvisioningCredential","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueCredentialRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/IssuedCredentialResponse"}}}}}}},"/api/admin/provisioning/connections/{connectionId}/credentials/{credentialId}/rotate":{"post":{"tags":["admin-provisioning-controller"],"summary":"Rotate a SCIM credential with bounded overlap","operationId":"rotateProvisioningCredential","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"credentialId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueCredentialRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/IssuedCredentialResponse"}}}}}}},"/api/admin/knowledge-spaces":{"get":{"tags":["admin-knowledge-space-controller"],"summary":"List Knowledge Spaces and the grants stored against them","operationId":"listAdminKnowledgeSpaces","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminKnowledgeSpaceResponse"}}}}}}},"post":{"tags":["admin-knowledge-space-controller"],"summary":"Create a Knowledge Space","operationId":"createAdminKnowledgeSpace","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateKnowledgeSpaceRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminKnowledgeSpaceResponse"}}}}}}},"/api/admin/knowledge-spaces/{knowledgeSpaceId}/grants":{"post":{"tags":["admin-knowledge-space-controller"],"summary":"Grant a subject access to a Knowledge Space","operationId":"grantAdminKnowledgeSpaceAccess","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GrantKnowledgeSpaceAccessRequest"}}},"required":true},"responses":{"204":{"description":"No Content"}}},"delete":{"tags":["admin-knowledge-space-controller"],"summary":"Revoke a subject's access to a Knowledge Space","operationId":"revokeAdminKnowledgeSpaceAccess","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"relation","in":"query","required":true,"schema":{"type":"string"}},{"name":"kind","in":"query","required":true,"schema":{"type":"string","enum":["ORGANIZATION","DEPARTMENT","DEPARTMENT_MANAGERS","ROLE","USER"]}},{"name":"subjectId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}},{"name":"role","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"204":{"description":"No Content"}}}},"/api/admin/invitations":{"get":{"tags":["admin-invitation-controller"],"summary":"List invited addresses and their status","operationId":"listAdminInvitations","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminInvitationResponse"}}}}}}},"post":{"tags":["admin-invitation-controller"],"summary":"Expect an address to sign in","operationId":"createAdminInvitation","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInvitationRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminInvitationResponse"}}}}}}},"/api/admin/connectors/{sourceSystem}/{connectionKey}/test":{"post":{"tags":["admin-connector-controller"],"summary":"Check a connection's stored credential","operationId":"testAdminConnection","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}},{"name":"connectionKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminConnectorProbeResponse"}}}}}}},"/api/admin/connectors/{sourceSystem}/{connectionKey}/crawl":{"post":{"tags":["admin-connector-controller"],"summary":"Ask for a content crawl on the next poll","operationId":"requestAdminConnectionCrawl","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}},{"name":"connectionKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"202":{"description":"Accepted"}}}},"/api/admin/connectors/{sourceSystem}/test":{"post":{"tags":["admin-connector-controller"],"summary":"Check a credential without storing it","operationId":"testAdminConnectorCredential","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectorCredentialRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminConnectorProbeResponse"}}}}}}},"/api/admin/ai/gateways":{"get":{"tags":["admin-ai-model-controller"],"summary":"List organization AI gateway profiles","operationId":"listAdminAiGateways","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GatewayResponse"}}}}}}},"post":{"tags":["admin-ai-model-controller"],"summary":"Connect an organization AI gateway","operationId":"createAdminAiGateway","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateGatewayRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GatewayResponse"}}}}}}},"/api/admin/ai/gateways/{profileId}/test":{"post":{"tags":["admin-ai-model-controller"],"summary":"Test a stored organization AI gateway","operationId":"testStoredAdminAiGateway","parameters":[{"name":"profileId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProbeResponse"}}}}}}},"/api/admin/ai/gateways/test":{"post":{"tags":["admin-ai-model-controller"],"summary":"Test an AI gateway credential without storing it","operationId":"testAdminAiGateway","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestGatewayRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ProbeResponse"}}}}}}},"/api/admin/access/explain":{"post":{"tags":["admin-permission-controller"],"summary":"Answer whether a user holds a permission on one resource, and by which derivation","operationId":"explainAdminAccess","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExplainAccessRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ExplainAccessResponse"}}}}}}},"/api/assistant/conversations/{conversationId}":{"delete":{"tags":["assistant-controller"],"summary":"Delete the current actor's conversation transcript","operationId":"deleteAssistantConversation","parameters":[{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}},"patch":{"tags":["assistant-controller"],"summary":"Rename the current actor's conversation","operationId":"renameAssistantConversation","parameters":[{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenameConversationRequest"}}},"required":true},"responses":{"204":{"description":"No Content"}}}},"/api/admin/users/{userId}":{"patch":{"tags":["admin-user-controller"],"summary":"Change a user's clearance, department, or activation","operationId":"updateAdminUser","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAdminUserRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminUserResponse"}}}}}}},"/api/admin/provisioning/connections/{connectionId}/state":{"patch":{"tags":["admin-provisioning-controller"],"summary":"Compare-and-set SCIM connection state","operationId":"updateProvisioningConnectionState","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateStateRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ConnectionResponse"}}}}}}},"/api/sources/{sourceId}/content":{"get":{"tags":["source-content-controller"],"summary":"Stream permission-verified current source evidence","operationId":"readSourceContent","parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StreamingResponseBody"}}}}}}},"/api/session":{"get":{"tags":["browser-session-controller"],"summary":"Read the current browser session","operationId":"getBrowserSession","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SessionResponse"}}}}}}},"/api/session/csrf":{"get":{"tags":["browser-session-controller"],"summary":"Issue a CSRF token for browser mutations","operationId":"getBrowserCsrfToken","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CsrfResponse"}}}}}}},"/api/organization/context":{"get":{"tags":["organization-context-controller"],"operationId":"context","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/OrganizationContextResponse"}}}}}}},"/api/me":{"get":{"tags":["me-controller"],"summary":"Read the current user's governed profile","operationId":"getMe","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}}}}},"/api/knowledge/search":{"get":{"tags":["knowledge-search-controller"],"summary":"Search permission-verified knowledge evidence","operationId":"searchKnowledge","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/KnowledgeSearchResponse"}}}}}}},"/api/knowledge/catalog":{"get":{"tags":["knowledge-catalog-controller"],"summary":"List current permission-verified Knowledge versions for composition","operationId":"listKnowledgeCatalog","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeCatalogItem"}}}}}}}},"/api/knowledge-spaces/{knowledgeSpaceId}/graph/export":{"get":{"tags":["knowledge-graph-management-controller"],"summary":"Export only graph evidence visible to the current user","operationId":"exportKnowledgeGraph","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","default":"JSON","enum":["JSON","CSV","MARKDOWN","TEXT"]}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"string"}}}}}}},"/api/knowledge-spaces/{knowledgeSpaceId}/graph/explorer":{"get":{"tags":["knowledge-graph-explorer-controller"],"summary":"Read a bounded permission-filtered graph view","operationId":"exploreKnowledgeGraph","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"entityLimit","in":"query","required":false,"schema":{"type":"integer","format":"int32"}},{"name":"maxDepth","in":"query","required":false,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/KnowledgeGraphView"}}}}}}},"/api/knowledge-spaces/visible":{"get":{"tags":["knowledge-space-controller"],"summary":"List Knowledge Spaces visible to the current user","operationId":"listVisibleKnowledgeSpaces","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeSpaceResponse"}}}}}}}},"/api/knowledge-spaces/upload-targets":{"get":{"tags":["knowledge-space-controller"],"summary":"List Knowledge Spaces where the current user may add knowledge","operationId":"listKnowledgeSpaceUploadTargets","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeSpaceResponse"}}}}}}}},"/api/knowledge-assets/graph-jobs/{jobId}":{"get":{"tags":["knowledge-asset-lifecycle-controller"],"summary":"Read graph indexing lifecycle status","operationId":"getGraphIndexJob","parameters":[{"name":"jobId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GraphIndexJobView"}}}}}}},"/api/health":{"get":{"tags":["health-controller"],"operationId":"health","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"object","additionalProperties":{"type":"string"}}}}}}}},"/api/citations/{chunkId}/excerpt":{"get":{"tags":["citation-content-controller"],"summary":"Read a bounded permission-verified citation excerpt","operationId":"readCitationExcerpt","parameters":[{"name":"chunkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CitationEvidenceExcerpt"}}}}}}},"/api/citations/{chunkId}/content":{"get":{"tags":["citation-content-controller"],"summary":"Stream permission-verified source evidence","operationId":"readCitationContent","parameters":[{"name":"chunkId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StreamingResponseBody"}}}}}}},"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/work-instruction":{"get":{"tags":["assistant-asset-tool-controller"],"summary":"Guide an exact Work Instruction release","operationId":"followAssistantWorkInstruction","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WorkInstructionToolResult"}}}}}}},"/api/assistant/tools/assets/{assetId}/releases/{releaseId}/prompt-form":{"get":{"tags":["assistant-asset-tool-controller"],"summary":"Resolve the variables required by an exact Prompt release","operationId":"prepareAssistantPrompt","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PromptFormResult"}}}}}}},"/api/assistant/tools/asset-recommendations":{"get":{"tags":["assistant-asset-tool-controller"],"summary":"Recommend exact usable Asset releases without leaking denied candidates","operationId":"recommendAssistantAssets","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RecommendationResult"}}}}}}},"/api/assistant/starters":{"get":{"tags":["assistant-controller"],"summary":"List supported prompts for starting an Assistant conversation","operationId":"listAssistantStarters","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssistantStarterPrompt"}}}}}}}},"/api/assistant/model-options":{"get":{"tags":["assistant-controller"],"summary":"List server-governed Assistant model choices for the current route","operationId":"getAssistantModelOptions","parameters":[{"name":"conversationId","in":"query","required":false,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssistantModelOptionsResponse"}}}}}}},"/api/assistant/messages/{messageId}/citations":{"get":{"tags":["assistant-controller"],"summary":"Hydrate currently authorized citations for one owned Assistant answer","operationId":"getAssistantMessageCitations","parameters":[{"name":"messageId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssistantCitationResponse"}}}}}}}},"/api/assistant/conversations":{"get":{"tags":["assistant-controller"],"summary":"List the current actor's conversations by recent activity","operationId":"listAssistantConversations","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssistantConversationSummary"}}}}}}}},"/api/assistant/conversations/{conversationId}/messages":{"get":{"tags":["assistant-controller"],"summary":"Replay a tenant- and actor-scoped full conversation transcript","operationId":"getAssistantConversationHistory","parameters":[{"name":"conversationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssistantConversationMessageView"}}}}}}}},"/api/assets/{assetId}":{"get":{"tags":["asset-registry-controller"],"summary":"Read an authorized Asset and its governance history","operationId":"getAsset","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetView"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/work-instruction":{"get":{"tags":["asset-consumption-controller"],"summary":"Follow an exact authorized Work Instruction release","operationId":"followWorkInstruction","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/WorkInstructionView"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/skill-manifest":{"get":{"tags":["asset-consumption-controller"],"summary":"Read the browser install contract for one exact authorized Skill release","operationId":"getSkillInstallContract","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SkillInstallManifest"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/pack-journey":{"get":{"tags":["asset-consumption-controller"],"summary":"Read an actor-scoped Capability Pack journey","operationId":"getCapabilityPackJourney","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PackJourney"}}}}}}},"/api/assets/{assetId}/releases/{releaseId}/pack-definition":{"get":{"tags":["asset-consumption-controller"],"summary":"Read the ordered authorized items pinned by a Capability Pack release","operationId":"getCapabilityPackDefinition","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CapabilityPackDefinition"}}}}}}},"/api/assets/{assetId}/governance-actions":{"get":{"tags":["asset-registry-controller"],"summary":"Read the current actor's available Governance actions","operationId":"getAssetGovernanceActions","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetGovernanceActions"}}}}}}},"/api/assets/skills/github/connections":{"get":{"tags":["asset-registry-controller"],"summary":"List approved GitHub connections available for private Skill import","operationId":"listGitHubSkillConnections","parameters":[{"name":"knowledgeSpaceId","in":"query","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ConnectionOption"}}}}}}}},"/api/assets/owned":{"get":{"tags":["asset-registry-controller"],"summary":"List Assets currently owned by the actor","operationId":"listOwnedAssets","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"RECENTLY_UPDATED","enum":["RECENTLY_UPDATED","NAME"]}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":24}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetSummaryPage"}}}}}}},"/api/assets/catalog":{"get":{"tags":["asset-consumption-controller"],"summary":"List exact usable Asset releases authorized for the current actor","operationId":"listAssetCatalog","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","default":"RECENTLY_RELEASED","enum":["RECENTLY_RELEASED","NAME"]}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":24}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetRecommendationPage"}}}}}}},"/api/asset-delivery":{"get":{"tags":["asset-delivery-controller"],"summary":"Search exact released Assets authorized for the current actor","operationId":"searchReleasedAssets","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AssetRecommendation"}}}}}}}},"/api/asset-delivery/{assetId}":{"get":{"tags":["asset-delivery-controller"],"summary":"Read the latest usable immutable release for an Asset","operationId":"getLatestReleasedAsset","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetDeliveryRelease"}}}}}}},"/api/asset-delivery/{assetId}/releases/{releaseId}":{"get":{"tags":["asset-delivery-controller"],"summary":"Read one exact usable immutable Asset release","operationId":"getReleasedAsset","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetDeliveryRelease"}}}}}}},"/api/asset-delivery/{assetId}/releases/{releaseId}/skill-package":{"get":{"tags":["asset-delivery-controller"],"summary":"Stream the verified package for one exact usable Skill release","operationId":"downloadReleasedSkillPackage","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StreamingResponseBody"}}}}}}},"/api/asset-delivery/{assetId}/releases/{releaseId}/skill-manifest":{"get":{"tags":["asset-delivery-controller"],"summary":"Read the install manifest for one exact usable Skill release","operationId":"getReleasedSkillManifest","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SkillInstallManifest"}}}}}}},"/api/asset-delivery/{assetId}/releases/{releaseId}/relations":{"get":{"tags":["asset-delivery-controller"],"summary":"Resolve only independently authorized relations of an exact release","operationId":"resolveReleasedAssetRelations","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AssetRelationResolution"}}}}}}},"/api/asset-delivery/{assetId}/releases/{releaseId}/pack":{"get":{"tags":["asset-delivery-controller"],"summary":"Read a Pack definition with independently authorized pinned items","operationId":"getReleasedCapabilityPack","parameters":[{"name":"assetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"releaseId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CapabilityPackDefinition"}}}}}}},"/api/asset-delivery/skills/{namespace}/{slug}/versions/{version}/manifest":{"get":{"tags":["asset-delivery-controller"],"summary":"Resolve an exact usable Skill release by coordinate and version","operationId":"resolveReleasedSkillManifest","parameters":[{"name":"namespace","in":"path","required":true,"schema":{"type":"string"}},{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"version","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/SkillInstallManifest"}}}}}}},"/api/admin/users":{"get":{"tags":["admin-user-controller"],"summary":"List internal users with their sign-in and mapping status","operationId":"listAdminUsers","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminUserResponse"}}}}}}}},"/api/admin/users/{userId}/permissions":{"get":{"tags":["admin-permission-controller"],"summary":"Resolve a user's organization permissions as the engine currently answers them","operationId":"listAdminUserPermissions","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/EffectivePermissionResponse"}}}}}}},"/api/admin/source-principals":{"get":{"tags":["admin-source-access-controller"],"summary":"List observed principals and their mapping","operationId":"listAdminSourcePrincipals","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminSourcePrincipalResponse"}}}}}}}},"/api/admin/source-groups":{"get":{"tags":["admin-source-access-controller"],"summary":"List source groups with their sealed membership","operationId":"listAdminSourceGroups","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminSourceGroupResponse"}}}}}}}},"/api/admin/source-connections":{"get":{"tags":["admin-source-access-controller"],"summary":"List observed connections and their trust level","operationId":"listAdminSourceConnections","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminSourceConnectionResponse"}}}}}}}},"/api/admin/roles":{"get":{"tags":["admin-role-controller"],"summary":"List roles and who is assigned to them","operationId":"listAdminRoles","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminRoleListResponse"}}}}}}},"/api/admin/knowledge-spaces/grant-options":{"get":{"tags":["admin-knowledge-space-controller"],"summary":"List the subject shapes each Knowledge Space relation accepts","operationId":"listAdminKnowledgeSpaceGrantOptions","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeSpaceGrantOptionResponse"}}}}}}}},"/api/admin/connectors/{sourceSystem}":{"get":{"tags":["admin-connector-controller"],"summary":"List a source's connections and their crawl settings","operationId":"listAdminConnections","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminConnectionResponse"}}}}}}}},"/api/admin/connectors/{sourceSystem}/{connectionKey}/scopes":{"get":{"tags":["admin-connector-controller"],"summary":"List what a connection can be pointed at","operationId":"listAdminConnectionScopes","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}},{"name":"connectionKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminConnectorScopeResponse"}}}}}}}},"/api/admin/connectors/{sourceSystem}/{connectionKey}/activity":{"get":{"tags":["admin-connector-controller"],"summary":"Read what a connection has crawled and what went wrong","operationId":"getAdminConnectionActivity","parameters":[{"name":"sourceSystem","in":"path","required":true,"schema":{"type":"string"}},{"name":"connectionKey","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/AdminConnectionActivityResponse"}}}}}}},"/api/admin/connectors/sources":{"get":{"tags":["admin-connector-controller"],"summary":"List the sources this deployment can ingest","operationId":"listAdminConnectorSources","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminConnectorSourceResponse"}}}}}}}},"/api/admin/ai/routes":{"get":{"tags":["admin-ai-model-controller"],"summary":"List effective organization AI routes","operationId":"listAdminAiRoutes","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RouteResponse"}}}}}}}},"/api/admin/ai/providers":{"get":{"tags":["admin-ai-model-controller"],"summary":"List provider presets implemented by this deployment","operationId":"listAdminAiProviderPresets","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProviderPresetResponse"}}}}}}}},"/api/admin/ai/index-settings":{"get":{"tags":["admin-ai-model-controller"],"summary":"Read immutable deployment-managed embedding settings","operationId":"getAdminAiIndexSettings","responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/IndexSettingsResponse"}}}}}}},"/api/sources/{sourceId}":{"delete":{"tags":["source-controller"],"summary":"Retire a ready manual-upload document","operationId":"deleteSource","parameters":[{"name":"sourceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/KnowledgeAssetRef"}}}}}}},"/api/knowledge-spaces/{knowledgeSpaceId}/graph/curations/{curationId}":{"delete":{"tags":["knowledge-graph-management-controller"],"summary":"Reverse a graph curation record","operationId":"deactivateGraphCuration","parameters":[{"name":"knowledgeSpaceId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"curationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"authorizationGeneration","in":"query","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"reason","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/knowledge-assets/{knowledgeAssetId}":{"delete":{"tags":["knowledge-asset-lifecycle-controller"],"summary":"Retire a Knowledge Asset and remove its derived graph","operationId":"deleteKnowledgeAsset","parameters":[{"name":"knowledgeAssetId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/KnowledgeAssetRef"}}}}}}},"/api/admin/roles/{role}/members/{userId}":{"delete":{"tags":["admin-role-controller"],"summary":"Remove a user from a role","operationId":"revokeAdminRole","parameters":[{"name":"role","in":"path","required":true,"schema":{"type":"string"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}}},"/api/admin/provisioning/connections/{connectionId}/credentials/{credentialId}":{"delete":{"tags":["admin-provisioning-controller"],"summary":"Immediately revoke a SCIM credential","operationId":"revokeProvisioningCredential","parameters":[{"name":"connectionId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"credentialId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}}},"/api/admin/invitations/{invitationId}":{"delete":{"tags":["admin-invitation-controller"],"summary":"Withdraw an invitation that has not been used","operationId":"revokeAdminInvitation","parameters":[{"name":"invitationId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"204":{"description":"No Content"}}}}},"components":{"schemas":{"PackProgressRequest":{"type":"object","properties":{"completed":{"type":"boolean"},"confirmed":{"type":"boolean"}}},"Item":{"type":"object","properties":{"key":{"type":"string"},"required":{"type":"boolean"},"order":{"type":"integer","format":"int32"},"kind":{"type":"string"},"resourceId":{"type":"string","format":"uuid"},"pinnedVersionId":{"type":"string","format":"uuid"},"title":{"type":"string"},"versionLabel":{"type":"string"},"availability":{"type":"string","enum":["AVAILABLE","DEPRECATED","WITHDRAWN"]},"completed":{"type":"boolean"},"completedAt":{"type":"string","format":"date-time"}}},"PackJourney":{"type":"object","properties":{"assignmentId":{"type":"string","format":"uuid"},"packAssetId":{"type":"string","format":"uuid"},"packReleaseId":{"type":"string","format":"uuid"},"releaseDigest":{"type":"string"},"title":{"type":"string"},"versionLabel":{"type":"string"},"purpose":{"type":"string","enum":["ROLE_ONBOARDING","HANDOVER","ROLE_ENABLEMENT"]},"audience":{"type":"string"},"expectedOutcome":{"type":"string"},"status":{"type":"string","enum":["IN_PROGRESS","COMPLETED"]},"accessGap":{"type":"boolean"},"completedAccessibleItems":{"type":"integer","format":"int32"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Item"}},"startedAt":{"type":"string","format":"date-time"},"completedAt":{"type":"string","format":"date-time"}}},"PackToolResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"journey":{"$ref":"#/components/schemas/PackJourney"}}},"AnswerFeedbackRequest":{"type":"object","properties":{"sentiment":{"type":"string","enum":["HELPFUL","NOT_HELPFUL"]}},"required":["sentiment"]},"AssistantAnswerFeedbackView":{"type":"object","properties":{"messageId":{"type":"string","format":"uuid"},"sentiment":{"type":"string","enum":["HELPFUL","NOT_HELPFUL"]},"updatedAt":{"type":"string","format":"date-time"}}},"SelectAssistantModelRequest":{"type":"object","properties":{"modelActivationId":{"type":"string","format":"uuid"}}},"AssetView":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]},"namespace":{"type":"string"},"slug":{"type":"string"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"portfolioState":{"type":"string","enum":["DRAFT_ONLY","ACTIVE","SUNSETTING","RETIRED"]},"authorizationReady":{"type":"boolean"},"draft":{"$ref":"#/components/schemas/Draft"},"revisions":{"type":"array","items":{"$ref":"#/components/schemas/Revision"}},"reviews":{"type":"array","items":{"$ref":"#/components/schemas/Review"}},"releases":{"type":"array","items":{"$ref":"#/components/schemas/Release"}},"ownershipHealth":{"$ref":"#/components/schemas/OwnershipHealth"},"roleAssignments":{"type":"array","items":{"$ref":"#/components/schemas/RoleAssignment"}}}},"AvailabilityEvent":{"type":"object","properties":{"availability":{"type":"string","enum":["AVAILABLE","DEPRECATED","WITHDRAWN"]},"reason":{"type":"string"},"changedByUserId":{"type":"string","format":"uuid"},"effectiveAt":{"type":"string","format":"date-time"}}},"Decision":{"type":"object","properties":{"reviewerUserId":{"type":"string","format":"uuid"},"decision":{"type":"string","enum":["REQUEST_CHANGES","REJECT","APPROVE","CANCEL"]},"comment":{"type":"string"},"decidedAt":{"type":"string","format":"date-time"}}},"Draft":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"lockVersion":{"type":"integer","format":"int64"},"title":{"type":"string"},"summary":{"type":"string"},"classification":{"type":"string"},"schemaVersion":{"type":"string"},"payload":{"type":"string"},"editedByUserId":{"type":"string","format":"uuid"},"updatedAt":{"type":"string","format":"date-time"}}},"OwnershipHealth":{"type":"object","properties":{"ownerPresent":{"type":"boolean"},"backupOwnerPresent":{"type":"boolean"},"orphaned":{"type":"boolean"},"continuityAtRisk":{"type":"boolean"}}},"Release":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"revisionId":{"type":"string","format":"uuid"},"sequence":{"type":"integer","format":"int64"},"versionLabel":{"type":"string"},"publicationMode":{"type":"string","enum":["REVIEWED","DIRECT"]},"title":{"type":"string"},"summary":{"type":"string"},"classification":{"type":"string"},"schemaVersion":{"type":"string"},"payload":{"type":"string"},"digest":{"type":"string"},"releasedByUserId":{"type":"string","format":"uuid"},"releasedAt":{"type":"string","format":"date-time"},"availability":{"type":"string","enum":["AVAILABLE","DEPRECATED","WITHDRAWN"]},"availabilityHistory":{"type":"array","items":{"$ref":"#/components/schemas/AvailabilityEvent"}}}},"Review":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"revisionId":{"type":"string","format":"uuid"},"revisionDigest":{"type":"string"},"state":{"type":"string","enum":["IN_REVIEW","CHANGES_REQUESTED","REJECTED","CANCELLED","APPROVED"]},"policyVersion":{"type":"string"},"requestedByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"},"resolvedAt":{"type":"string","format":"date-time"},"decisions":{"type":"array","items":{"$ref":"#/components/schemas/Decision"}}}},"Revision":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"sequence":{"type":"integer","format":"int64"},"title":{"type":"string"},"summary":{"type":"string"},"classification":{"type":"string"},"schemaVersion":{"type":"string"},"payload":{"type":"string"},"digest":{"type":"string"},"changeNote":{"type":"string"},"createdByUserId":{"type":"string","format":"uuid"},"createdAt":{"type":"string","format":"date-time"}}},"RoleAssignment":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"principalType":{"type":"string"},"principalId":{"type":"string"},"role":{"type":"string","enum":["OWNER","BACKUP_OWNER","STEWARD","VIEWER","EDITOR","REVIEWER","PUBLISHER"]},"validFrom":{"type":"string","format":"date-time"},"validUntil":{"type":"string","format":"date-time"},"assignedByUserId":{"type":"string","format":"uuid"},"projectedAt":{"type":"string","format":"date-time"}}},"UpdateAssetDraftRequest":{"type":"object","properties":{"expectedLockVersion":{"type":"integer","format":"int64"},"title":{"type":"string"},"summary":{"type":"string"},"classification":{"type":"string"},"schemaVersion":{"type":"string"},"payload":{"type":"string"}}},"ConfirmMappingRequest":{"type":"object","properties":{"appUserId":{"type":"string","format":"uuid"}}},"AdminSourceMappingResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"appUserId":{"type":"string","format":"uuid"},"appUserName":{"type":"string"},"appUserEmail":{"type":"string"},"method":{"type":"string","enum":["IDP_JOIN","SSO_EMAIL_JOIN","SELF_CLAIM","ADMIN_CONFIRMED"]},"status":{"type":"string","enum":["ACTIVE","REVOKED"]},"evidence":{"type":"string"},"verifiedAt":{"type":"string","format":"date-time"}}},"AdminSourcePrincipalResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"sourceSystem":{"type":"string"},"sourceConnectionKey":{"type":"string"},"nativePrincipalId":{"type":"string"},"kind":{"type":"string","enum":["SOURCE_USER","SOURCE_GROUP"]},"observedEmail":{"type":"string"},"observedDisplayName":{"type":"string"},"ssoVerified":{"type":"boolean"},"lastSeenAt":{"type":"string","format":"date-time"},"mapping":{"$ref":"#/components/schemas/AdminSourceMappingResponse"}}},"IdentityTrustRequest":{"type":"object","properties":{"sourceSystem":{"type":"string"},"sourceConnectionKey":{"type":"string"},"identityTrust":{"type":"string","enum":["UNTRUSTED","SSO_VERIFIED"]}}},"AdminSourceConnectionResponse":{"type":"object","properties":{"sourceSystem":{"type":"string"},"sourceConnectionKey":{"type":"string"},"identityTrust":{"type":"string","enum":["UNTRUSTED","SSO_VERIFIED"]},"trustDecidedByUserId":{"type":"string","format":"uuid"},"trustDecidedAt":{"type":"string","format":"date-time"},"userCount":{"type":"integer","format":"int32"},"mappedUserCount":{"type":"integer","format":"int32"},"unmappedUserCount":{"type":"integer","format":"int32"},"groupCount":{"type":"integer","format":"int32"},"lastSeenAt":{"type":"string","format":"date-time"}}},"ConfigureConnectionRequest":{"type":"object","properties":{"crawlEnabled":{"type":"boolean"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"actorUserId":{"type":"string","format":"uuid"},"sourceConfig":{"type":"object","additionalProperties":{}},"contentCrawlIntervalSeconds":{"type":"integer","format":"int64"}}},"AdminConnectionResponse":{"type":"object","properties":{"sourceSystem":{"type":"string"},"sourceConnectionKey":{"type":"string"},"identityTrust":{"type":"string","enum":["UNTRUSTED","SSO_VERIFIED"]},"crawlEnabled":{"type":"boolean"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"actorUserId":{"type":"string","format":"uuid"},"sourceConfig":{"type":"object","additionalProperties":{}},"contentCrawlIntervalSeconds":{"type":"integer","format":"int64"},"credentialSet":{"type":"boolean"},"credentialSetByUserId":{"type":"string","format":"uuid"},"credentialSetAt":{"type":"string","format":"date-time"},"configuredByUserId":{"type":"string","format":"uuid"},"configuredAt":{"type":"string","format":"date-time"}}},"ConnectorCredentialRequest":{"type":"object","properties":{"credential":{"type":"string"}}},"SetRouteRequest":{"type":"object","properties":{"gatewayProfileId":{"type":"string","format":"uuid"},"modelId":{"type":"string"},"openAiReasoningEffort":{"type":"string","enum":["NONE","LOW","MEDIUM","HIGH","XHIGH","MAX"]}}},"RouteResponse":{"type":"object","properties":{"workload":{"type":"string","enum":["ASSISTANT_CHAT","PROMPT_EXECUTION","KEYWORD_PLANNING","GRAPH_EXTRACTION","QUERY_EMBEDDING","DOCUMENT_EMBEDDING"]},"gatewayKey":{"type":"string"},"gatewayProfileId":{"type":"string","format":"uuid"},"modelId":{"type":"string"},"openAiReasoningEffort":{"type":"string","enum":["NONE","LOW","MEDIUM","HIGH","XHIGH","MAX"]},"source":{"type":"string"},"editable":{"type":"boolean"},"version":{"type":"integer","format":"int64"},"lifecycleNote":{"type":"string"}}},"UpdateGatewayRequest":{"type":"object","properties":{"displayName":{"type":"string"},"baseUrl":{"type":"string"},"requestTimeoutSeconds":{"type":"integer","format":"int32"},"supportsOpenAiReasoningEffort":{"type":"boolean"},"credential":{"type":"string"}}},"AssistantModelResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"modelId":{"type":"string"},"displayName":{"type":"string"}}},"GatewayResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"gatewayKey":{"type":"string"},"displayName":{"type":"string"},"preset":{"type":"string","enum":["OPENAI","ANTHROPIC","NINE_ROUTER","OPENROUTER","LITELLM","OLLAMA","OPENAI_COMPATIBLE"]},"category":{"type":"string","enum":["DIRECT_PROVIDER","GATEWAY_ROUTER","SELF_HOSTED_CUSTOM"]},"protocol":{"type":"string","enum":["OPENAI_COMPATIBLE","ANTHROPIC_MESSAGES"]},"supportsOpenAiReasoningEffort":{"type":"boolean"},"baseUrl":{"type":"string"},"requestTimeoutSeconds":{"type":"integer","format":"int32"},"enabled":{"type":"boolean"},"version":{"type":"integer","format":"int64"},"credentialSet":{"type":"boolean"},"credentialSetByUserId":{"type":"string","format":"uuid"},"credentialSetAt":{"type":"string","format":"date-time"},"assistantModels":{"type":"array","items":{"$ref":"#/components/schemas/AssistantModelResponse"}}}},"GatewayCredentialRequest":{"type":"object","properties":{"credential":{"type":"string"}}},"AssistantModelDefinitionRequest":{"type":"object","properties":{"modelId":{"type":"string"},"displayName":{"type":"string"}}},"AssistantModelsRequest":{"type":"object","properties":{"models":{"type":"array","items":{"$ref":"#/components/schemas/AssistantModelDefinitionRequest"}}}},"SourceResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"sourceSystem":{"type":"string"},"aclAuthority":{"type":"string"},"status":{"type":"string"},"classification":{"type":"string"},"fileName":{"type":"string"},"mediaType":{"type":"string"},"contentLength":{"type":"integer","format":"int64"},"failureCode":{"type":"string"},"failureMessage":{"type":"string"},"knowledgeAssetId":{"type":"string","format":"uuid"},"knowledgeSpaceKey":{"type":"string"},"knowledgeSpaceName":{"type":"string"},"owningDepartmentName":{"type":"string"},"uploadedByName":{"type":"string"},"publicationComplete":{"type":"boolean"},"contentAvailable":{"type":"boolean"},"deletionAllowed":{"type":"boolean"},"embeddingProfileKey":{"type":"string"},"embeddingProvider":{"type":"string"},"embeddingModel":{"type":"string"},"embeddingDimensions":{"type":"integer","format":"int32"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"SuppressIdentityRequest":{"type":"object","properties":{"idempotencyKey":{"type":"string"},"reason":{"type":"string"},"authorizationGeneration":{"type":"integer","format":"int64"},"kind":{"type":"string","enum":["ENTITY","RELATION"]},"identityId":{"type":"string","format":"uuid"}}},"CuratedEntity":{"allOf":[{"$ref":"#/components/schemas/GraphCurationRecord"},{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"namespace":{"$ref":"#/components/schemas/ProjectionNamespace"},"entity":{"$ref":"#/components/schemas/GraphIdentityRef"},"name":{"type":"string"},"type":{"type":"string"},"description":{"type":"string"},"governingEvidence":{"$ref":"#/components/schemas/EvidenceReference"},"provenance":{"$ref":"#/components/schemas/CurationProvenance"}}}]},"CuratedRelation":{"allOf":[{"$ref":"#/components/schemas/GraphCurationRecord"},{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"namespace":{"$ref":"#/components/schemas/ProjectionNamespace"},"relation":{"$ref":"#/components/schemas/GraphIdentityRef"},"sourceEntity":{"$ref":"#/components/schemas/GraphIdentityRef"},"targetEntity":{"$ref":"#/components/schemas/GraphIdentityRef"},"type":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"weight":{"type":"number","format":"double"},"governingEvidence":{"$ref":"#/components/schemas/EvidenceReference"},"provenance":{"$ref":"#/components/schemas/CurationProvenance"}}}]},"CurationProvenance":{"type":"object","properties":{"actorUserId":{"type":"string","format":"uuid"},"authorizationModelId":{"type":"string"},"aclGeneration":{"type":"integer","format":"int64"},"curatedAt":{"type":"string","format":"date-time"},"reason":{"type":"string"}}},"EvidenceReference":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid"},"knowledgeAssetId":{"type":"string","format":"uuid"},"sourceRevisionId":{"type":"string","format":"uuid"},"chunkId":{"type":"string","format":"uuid"},"aclSnapshotId":{"type":"string","format":"uuid"},"aclGeneration":{"type":"integer","format":"int64"},"chunk":{"type":"boolean"}}},"GraphCurationRecord":{},"GraphIdentityRef":{"type":"object","properties":{"kind":{"type":"string","enum":["ENTITY","RELATION"]},"id":{"type":"string","format":"uuid"}}},"IdentityAlias":{"allOf":[{"$ref":"#/components/schemas/GraphCurationRecord"},{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"namespace":{"$ref":"#/components/schemas/ProjectionNamespace"},"source":{"$ref":"#/components/schemas/GraphIdentityRef"},"target":{"$ref":"#/components/schemas/GraphIdentityRef"},"provenance":{"$ref":"#/components/schemas/CurationProvenance"}}}]},"IdentitySuppression":{"allOf":[{"$ref":"#/components/schemas/GraphCurationRecord"},{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"namespace":{"$ref":"#/components/schemas/ProjectionNamespace"},"identity":{"$ref":"#/components/schemas/GraphIdentityRef"},"provenance":{"$ref":"#/components/schemas/CurationProvenance"}}}]},"ProjectionNamespace":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid"},"workspace":{"type":"string"},"collection":{"type":"string"}}},"CurateRelationRequest":{"type":"object","properties":{"idempotencyKey":{"type":"string"},"reason":{"type":"string"},"authorizationGeneration":{"type":"integer","format":"int64"},"relationId":{"type":"string","format":"uuid"},"sourceEntityId":{"type":"string","format":"uuid"},"targetEntityId":{"type":"string","format":"uuid"},"type":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"weight":{"type":"number","format":"double"},"evidence":{"$ref":"#/components/schemas/EvidenceRequest"}}},"EvidenceRequest":{"type":"object","properties":{"knowledgeAssetId":{"type":"string","format":"uuid"},"sourceRevisionId":{"type":"string","format":"uuid"},"chunkId":{"type":"string","format":"uuid"},"aclSnapshotId":{"type":"string","format":"uuid"},"aclGeneration":{"type":"integer","format":"int64"}}},"CurateEntityRequest":{"type":"object","properties":{"idempotencyKey":{"type":"string"},"reason":{"type":"string"},"authorizationGeneration":{"type":"integer","format":"int64"},"entityId":{"type":"string","format":"uuid"},"name":{"type":"string"},"type":{"type":"string"},"description":{"type":"string"},"evidence":{"$ref":"#/components/schemas/EvidenceRequest"}}},"AliasIdentityRequest":{"type":"object","properties":{"idempotencyKey":{"type":"string"},"reason":{"type":"string"},"authorizationGeneration":{"type":"integer","format":"int64"},"kind":{"type":"string","enum":["ENTITY","RELATION"]},"sourceIdentityId":{"type":"string","format":"uuid"},"targetIdentityId":{"type":"string","format":"uuid"}}},"GraphIndexJobView":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"knowledgeAssetId":{"type":"string","format":"uuid"},"knowledgeAssetVersionId":{"type":"string","format":"uuid"},"sourceRevisionId":{"type":"string","format":"uuid"},"projectionGeneration":{"type":"integer","format":"int64"},"graphProcessingProfileId":{"type":"string","format":"uuid"},"graphProcessingProfileSha256":{"type":"string"},"status":{"type":"string"},"attempt":{"type":"integer","format":"int32"},"cancellationRequested":{"type":"boolean"},"cancellationRequestedAt":{"type":"string","format":"date-time"},"lastErrorCode":{"type":"string"},"lastErrorMessage":{"type":"string"},"completedAt":{"type":"string","format":"date-time"}}},"KnowledgeSearchRequest":{"type":"object","properties":{"query":{"type":"string"},"requestId":{"type":"string"}}},"KnowledgeCitation":{"type":"object","properties":{"chunkId":{"type":"string","format":"uuid"},"knowledgeAssetId":{"type":"string","format":"uuid"},"sourceRevisionId":{"type":"string","format":"uuid"},"title":{"type":"string"},"startPage":{"type":"integer","format":"int32"},"endPage":{"type":"integer","format":"int32"},"heading":{"type":"string"}}},"KnowledgeResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"requestId":{"type":"string"},"citations":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeCitation"}}}},"PromptRunRequest":{"type":"object","properties":{"variables":{"type":"object","additionalProperties":{}},"knowledgeQuery":{"type":"string"},"requestId":{"type":"string"},"confirmedExternalProvider":{"type":"boolean"}}},"AiRoute":{"type":"object","properties":{"gatewayId":{"type":"string"},"modelId":{"type":"string"},"openAiReasoningEffort":{"type":"string","enum":["NONE","LOW","MEDIUM","HIGH","XHIGH","MAX"]}}},"PromptCitation":{"type":"object","properties":{"chunkId":{"type":"string","format":"uuid"},"knowledgeAssetId":{"type":"string","format":"uuid"},"sourceRevisionId":{"type":"string","format":"uuid"},"title":{"type":"string"},"startPage":{"type":"integer","format":"int32"},"endPage":{"type":"integer","format":"int32"},"heading":{"type":"string"}}},"PromptRunResult":{"type":"object","properties":{"runId":{"type":"string","format":"uuid"},"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"releaseDigest":{"type":"string"},"modelRoute":{"$ref":"#/components/schemas/AiRoute"},"output":{"type":"string"},"citations":{"type":"array","items":{"$ref":"#/components/schemas/PromptCitation"}},"durationMillis":{"type":"integer","format":"int64"}}},"PromptRunToolResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"result":{"$ref":"#/components/schemas/PromptRunResult"}}},"PromptRenderRequest":{"type":"object","properties":{"variables":{"type":"object","additionalProperties":{}}}},"PromptRenderResult":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"releaseDigest":{"type":"string"},"systemInstruction":{"type":"string"},"userPrompt":{"type":"string"},"sensitiveVariables":{"type":"array","items":{"type":"string"}},"inputShapeDigest":{"type":"string"}}},"PromptRenderToolResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"result":{"$ref":"#/components/schemas/PromptRenderResult"}}},"ConfirmedActionRequest":{"type":"object","properties":{"confirmed":{"type":"boolean"}}},"ForkRequest":{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"confirmed":{"type":"boolean"}}},"ForkResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"asset":{"$ref":"#/components/schemas/AssetView"}}},"FeedbackRequest":{"type":"object","properties":{"type":{"type":"string","enum":["HELPFUL","OUTDATED","INCORRECT","OTHER"]},"comment":{"type":"string"},"confirmed":{"type":"boolean"}}},"FeedbackResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"feedbackId":{"type":"string","format":"uuid"}}},"AssistantChatRequest":{"type":"object","properties":{"message":{"type":"string","maxLength":1000,"minLength":0},"limit":{"type":"integer","format":"int32"},"conversationId":{"type":"string","format":"uuid"},"modelActivationId":{"type":"string","format":"uuid"}},"required":["message"]},"ServerSentEventString":{},"AssetDraftRequest":{"type":"object","properties":{"title":{"type":"string"},"summary":{"type":"string"},"classification":{"type":"string"},"schemaVersion":{"type":"string"},"payload":{"type":"string"}}},"CreateAssetRequest":{"type":"object","properties":{"type":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK"]},"namespace":{"type":"string"},"slug":{"type":"string"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"draft":{"$ref":"#/components/schemas/AssetDraftRequest"}}},"SubmitAssetRevisionRequest":{"type":"object","properties":{"changeNote":{"type":"string"}}},"PublishSkillReleaseRequest":{"type":"object","properties":{"versionLabel":{"type":"string"}}},"AssignAssetRoleRequest":{"type":"object","properties":{"principalType":{"type":"string"},"principalId":{"type":"string"},"role":{"type":"string","enum":["OWNER","BACKUP_OWNER","STEWARD","VIEWER","EDITOR","REVIEWER","PUBLISHER"]}}},"AssetReviewDecisionRequest":{"type":"object","properties":{"decision":{"type":"string","enum":["REQUEST_CHANGES","REJECT","APPROVE","CANCEL"]},"comment":{"type":"string"}}},"PublishAssetReleaseRequest":{"type":"object","properties":{"revisionId":{"type":"string","format":"uuid"},"versionLabel":{"type":"string"}}},"Step":{"type":"object","properties":{"key":{"type":"string"},"title":{"type":"string"},"instruction":{"type":"string"},"expectedResult":{"type":"string"},"check":{"type":"string"},"escalation":{"type":"string"},"prohibitedActions":{"type":"array","items":{"type":"string"}},"relatedAssetIds":{"type":"array","items":{"type":"string","format":"uuid"}},"relatedKnowledgeVersionIds":{"type":"array","items":{"type":"string","format":"uuid"}}}},"WorkInstructionSpec":{"type":"object","properties":{"purpose":{"type":"string"},"audience":{"type":"string"},"prerequisites":{"type":"array","items":{"type":"string"}},"completionOutcome":{"type":"string"},"responsibleRole":{"type":"string"},"steps":{"type":"array","items":{"$ref":"#/components/schemas/Step"}}}},"WorkInstructionView":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"releaseDigest":{"type":"string"},"title":{"type":"string"},"versionLabel":{"type":"string"},"instruction":{"$ref":"#/components/schemas/WorkInstructionSpec"},"acknowledged":{"type":"boolean"},"acknowledgedAt":{"type":"string","format":"date-time"}}},"AssetAvailabilityRequest":{"type":"object","properties":{"reason":{"type":"string"}}},"PromptVariablesRequest":{"type":"object","properties":{"variables":{"type":"object","additionalProperties":{}}}},"CaseResult":{"type":"object","properties":{"name":{"type":"string"},"passed":{"type":"boolean"},"failedAssertions":{"type":"array","items":{"type":"string"}},"promptRunId":{"type":"string","format":"uuid"}}},"PromptEvaluationResult":{"type":"object","properties":{"evaluationId":{"type":"string","format":"uuid"},"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"releaseDigest":{"type":"string"},"passedCases":{"type":"integer","format":"int32"},"totalCases":{"type":"integer","format":"int32"},"cases":{"type":"array","items":{"$ref":"#/components/schemas/CaseResult"}}}},"ForkReleaseRequest":{"type":"object","properties":{"namespace":{"type":"string"},"slug":{"type":"string"},"knowledgeSpaceId":{"type":"string","format":"uuid"}}},"PromptComparisonRequest":{"type":"object","properties":{"baselineReleaseId":{"type":"string","format":"uuid"},"candidateReleaseId":{"type":"string","format":"uuid"}}},"PromptEvaluationComparison":{"type":"object","properties":{"baseline":{"$ref":"#/components/schemas/PromptEvaluationResult"},"candidate":{"$ref":"#/components/schemas/PromptEvaluationResult"},"passedCaseDelta":{"type":"integer","format":"int32"}}},"FileEntry":{"type":"object","properties":{"path":{"type":"string"},"size":{"type":"integer","format":"int64"},"sha256":{"type":"string"}}},"SkillPackageInspection":{"type":"object","properties":{"name":{"type":"string"},"description":{"type":"string"},"license":{"type":"string"},"compatibility":{"type":"string"},"allowedTools":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"instructions":{"type":"string"},"sha256":{"type":"string"},"contentLength":{"type":"integer","format":"int64"},"files":{"type":"array","items":{"$ref":"#/components/schemas/FileEntry"}}}},"GitHubSkillSourceRequest":{"type":"object","properties":{"repository":{"type":"string","maxLength":512,"minLength":0},"revision":{"type":"string"},"subpath":{"type":"string"},"connectionKey":{"type":"string"},"knowledgeSpaceId":{"type":"string","format":"uuid"}},"required":["knowledgeSpaceId","repository"]},"Preview":{"type":"object","properties":{"repository":{"type":"string"},"revision":{"type":"string"},"visibility":{"type":"string","enum":["PUBLIC","PRIVATE"]},"skills":{"type":"array","items":{"$ref":"#/components/schemas/PreviewItem"}}}},"PreviewItem":{"type":"object","properties":{"path":{"type":"string"},"importable":{"type":"boolean"},"name":{"type":"string"},"description":{"type":"string"},"fileCount":{"type":"integer","format":"int32"},"errorCode":{"type":"string"},"errorMessage":{"type":"string"}}},"GitHubSkillImportRequest":{"type":"object","properties":{"source":{"$ref":"#/components/schemas/GitHubSkillSourceRequest"},"paths":{"type":"array","items":{"type":"string","minLength":1},"maxItems":20,"minItems":1},"namespace":{"type":"string","maxLength":128,"minLength":0},"classification":{"type":"string","enum":["PUBLIC","INTERNAL","CONFIDENTIAL","RESTRICTED"]}},"required":["namespace","paths","source"]},"ImportItem":{"type":"object","properties":{"path":{"type":"string"},"imported":{"type":"boolean"},"asset":{"$ref":"#/components/schemas/AssetView"},"errorCode":{"type":"string"},"errorMessage":{"type":"string"}}},"ImportResult":{"type":"object","properties":{"repository":{"type":"string"},"revision":{"type":"string"},"visibility":{"type":"string","enum":["PUBLIC","PRIVATE"]},"skills":{"type":"array","items":{"$ref":"#/components/schemas/ImportItem"}}}},"AssignRoleRequest":{"type":"object","properties":{"userId":{"type":"string","format":"uuid"}}},"CreateConnectionRequest":{"type":"object","properties":{"alias":{"type":"string"},"providerProfile":{"type":"string","enum":["GENERIC_SCIM","MICROSOFT_ENTRA","OKTA"]}}},"ConnectionResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"alias":{"type":"string"},"providerProfile":{"type":"string","enum":["GENERIC_SCIM","MICROSOFT_ENTRA","OKTA"]},"configurationStatus":{"type":"string"},"operationalState":{"type":"string","enum":["DISABLED","VALIDATING","ENABLED","READ_ONLY","SUSPENDED"]},"usersEnabled":{"type":"boolean"},"groupsEnabled":{"type":"boolean"},"version":{"type":"integer","format":"int64"}}},"IssueCredentialRequest":{"type":"object","properties":{"usersScope":{"type":"boolean"},"groupsScope":{"type":"boolean"}}},"IssuedCredentialResponse":{"type":"object","properties":{"credentialId":{"type":"string","format":"uuid"},"token":{"type":"string"},"publicTokenId":{"type":"string"},"usersScope":{"type":"boolean"},"groupsScope":{"type":"boolean"},"expiresAt":{"type":"string","format":"date-time"}}},"CreateKnowledgeSpaceRequest":{"type":"object","properties":{"name":{"type":"string"},"audienceMode":{"type":"string","enum":["ORGANIZATION","DEPARTMENT","RESTRICTED_CUSTOM"]},"departmentId":{"type":"string","format":"uuid"}}},"AdminKnowledgeSpaceResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"key":{"type":"string"},"name":{"type":"string"},"audienceMode":{"type":"string","enum":["ORGANIZATION","DEPARTMENT","RESTRICTED_CUSTOM"]},"audienceVersion":{"type":"integer","format":"int64"},"departmentId":{"type":"string","format":"uuid"},"active":{"type":"boolean"},"grants":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeSpaceGrantResponse"}},"grantsComplete":{"type":"boolean"},"policyVersion":{"type":"string"}}},"KnowledgeSpaceGrantResponse":{"type":"object","properties":{"relation":{"type":"string"},"subject":{"type":"string"},"effective":{"type":"boolean"}}},"GrantKnowledgeSpaceAccessRequest":{"type":"object","properties":{"relation":{"type":"string"},"kind":{"type":"string","enum":["ORGANIZATION","DEPARTMENT","DEPARTMENT_MANAGERS","ROLE","USER"]},"subjectId":{"type":"string","format":"uuid"},"role":{"type":"string"}}},"CreateInvitationRequest":{"type":"object","properties":{"email":{"type":"string"},"clearance":{"type":"string","enum":["STANDARD","EXECUTIVE"]},"departmentId":{"type":"string","format":"uuid"}}},"AdminInvitationResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"email":{"type":"string"},"clearance":{"type":"string","enum":["STANDARD","EXECUTIVE"]},"departmentId":{"type":"string","format":"uuid"},"status":{"type":"string"},"invitedAt":{"type":"string","format":"date-time"},"acceptedAt":{"type":"string","format":"date-time"},"acceptedAppUserId":{"type":"string","format":"uuid"}}},"AdminConnectorProbeResponse":{"type":"object","properties":{"authenticated":{"type":"boolean"},"connectionKey":{"type":"string"},"accountName":{"type":"string"},"identityName":{"type":"string"},"canReadContent":{"type":"boolean"},"errorCode":{"type":"string"}}},"CreateGatewayRequest":{"type":"object","properties":{"gatewayKey":{"type":"string"},"displayName":{"type":"string"},"preset":{"type":"string","enum":["OPENAI","ANTHROPIC","NINE_ROUTER","OPENROUTER","LITELLM","OLLAMA","OPENAI_COMPATIBLE"]},"category":{"type":"string","enum":["DIRECT_PROVIDER","GATEWAY_ROUTER","SELF_HOSTED_CUSTOM"]},"protocol":{"type":"string","enum":["OPENAI_COMPATIBLE","ANTHROPIC_MESSAGES"]},"baseUrl":{"type":"string"},"requestTimeoutSeconds":{"type":"integer","format":"int32"},"supportsOpenAiReasoningEffort":{"type":"boolean"},"credential":{"type":"string"}}},"ModelRef":{"type":"object","properties":{"id":{"type":"string"},"displayName":{"type":"string"}}},"ProbeResponse":{"type":"object","properties":{"authenticated":{"type":"boolean"},"models":{"type":"array","items":{"$ref":"#/components/schemas/ModelRef"}},"errorCode":{"type":"string"}}},"TestGatewayRequest":{"type":"object","properties":{"preset":{"type":"string","enum":["OPENAI","ANTHROPIC","NINE_ROUTER","OPENROUTER","LITELLM","OLLAMA","OPENAI_COMPATIBLE"]},"protocol":{"type":"string","enum":["OPENAI_COMPATIBLE","ANTHROPIC_MESSAGES"]},"baseUrl":{"type":"string"},"requestTimeoutSeconds":{"type":"integer","format":"int32"},"credential":{"type":"string"}}},"ExplainAccessRequest":{"type":"object","properties":{"userId":{"type":"string","format":"uuid"},"permission":{"type":"string"},"resourceType":{"type":"string"},"resourceId":{"type":"string","format":"uuid"}}},"AccessBlockResponse":{"type":"object","properties":{"branch":{"type":"string"},"kind":{"type":"string"},"detail":{"type":"string"}}},"AccessStepResponse":{"type":"object","properties":{"object":{"type":"string"},"relation":{"type":"string"},"kind":{"type":"string"}}},"AclProvenanceResponse":{"type":"object","properties":{"authority":{"type":"string"},"origin":{"type":"string"},"generation":{"type":"integer","format":"int64"},"capturedAt":{"type":"string","format":"date-time"},"expired":{"type":"boolean"}}},"ExplainAccessResponse":{"type":"object","properties":{"state":{"type":"string","enum":["ALLOWED","DENIED","UNKNOWN"]},"reasonCode":{"type":"string"},"path":{"type":"array","items":{"$ref":"#/components/schemas/AccessStepResponse"}},"blockedBy":{"type":"array","items":{"$ref":"#/components/schemas/AccessBlockResponse"}},"provenance":{"$ref":"#/components/schemas/AclProvenanceResponse"},"evaluationKind":{"type":"string"},"relationshipState":{"type":"string","enum":["ALLOWED","DENIED","UNKNOWN"]},"relationshipReasonCode":{"type":"string"},"contentPolicyState":{"type":"string","enum":["ALLOWED","DENIED","UNKNOWN"]},"contentPolicyReasonCode":{"type":"string"},"resource":{"$ref":"#/components/schemas/ResourceSummaryResponse"},"policyVersion":{"type":"string"},"evaluatedAt":{"type":"string","format":"date-time"}}},"ResourceSummaryResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string"},"label":{"type":"string"},"contextLabel":{"type":"string"},"classification":{"type":"string"}}},"RenameConversationRequest":{"type":"object","properties":{"title":{"type":"string","maxLength":120,"minLength":0}},"required":["title"]},"UpdateAdminUserRequest":{"type":"object","properties":{"clearance":{"type":"string","enum":["STANDARD","EXECUTIVE"]},"active":{"type":"boolean"},"departmentId":{"type":["string","null"],"format":"uuid","description":"Omit to keep the current department; send null to clear it"}}},"AdminUserResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string"},"clearance":{"type":"string","enum":["STANDARD","EXECUTIVE"]},"departmentId":{"type":"string","format":"uuid"},"active":{"type":"boolean"},"signInLinked":{"type":"boolean"},"mappedPrincipalCount":{"type":"integer","format":"int32"}}},"UpdateStateRequest":{"type":"object","properties":{"expectedVersion":{"type":"integer","format":"int64"},"expectedState":{"type":"string","enum":["DISABLED","VALIDATING","ENABLED","READ_ONLY","SUSPENDED"]},"nextState":{"type":"string","enum":["DISABLED","VALIDATING","ENABLED","READ_ONLY","SUSPENDED"]}}},"SourcePageResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SourceResponse"}},"nextCursor":{"type":"string"},"pageSize":{"type":"integer","format":"int32"},"total":{"type":"integer","format":"int64"},"statusCounts":{"$ref":"#/components/schemas/SourceStatusCountsResponse"}}},"SourceStatusCountsResponse":{"type":"object","properties":{"processing":{"type":"integer","format":"int64"},"ready":{"type":"integer","format":"int64"},"attention":{"type":"integer","format":"int64"}}},"StreamingResponseBody":{},"SessionResponse":{"type":"object","properties":{"authenticated":{"type":"boolean"},"name":{"type":"string"},"email":{"type":"string"},"userId":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"departmentId":{"type":"string","format":"uuid"},"clearance":{"type":"string","enum":["STANDARD","EXECUTIVE"]},"canManageMembers":{"type":"boolean"}}},"CsrfResponse":{"type":"object","properties":{"headerName":{"type":"string"},"parameterName":{"type":"string"},"token":{"type":"string"}}},"DepartmentResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"name":{"type":"string"}}},"OrganizationContextResponse":{"type":"object","properties":{"organizationId":{"type":"string","format":"uuid"},"departments":{"type":"array","items":{"$ref":"#/components/schemas/DepartmentResponse"}},"users":{"type":"array","items":{"$ref":"#/components/schemas/UserResponse"}}}},"UserResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"departmentId":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string"},"clearance":{"type":"string","enum":["STANDARD","EXECUTIVE"]}}},"MeResponse":{"type":"object","properties":{"userId":{"type":"string","format":"uuid"},"organizationId":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string"},"departmentId":{"type":"string","format":"uuid"},"departmentName":{"type":"string"},"clearance":{"type":"string","enum":["STANDARD","EXECUTIVE"]}}},"KnowledgeEvidenceResponse":{"type":"object","properties":{"citationId":{"type":"string","format":"uuid"},"knowledgeAssetId":{"type":"string","format":"uuid"},"title":{"type":"string"},"content":{"type":"string"},"sourceUri":{"type":"string"},"startPage":{"type":"integer","format":"int32"},"endPage":{"type":"integer","format":"int32"},"heading":{"type":"string"},"relevanceScore":{"type":"number","format":"double"}}},"KnowledgeSearchResponse":{"type":"object","properties":{"requestId":{"type":"string"},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/KnowledgeEvidenceResponse"}}}},"KnowledgeCatalogItem":{"type":"object","properties":{"knowledgeAssetId":{"type":"string","format":"uuid"},"knowledgeVersionId":{"type":"string","format":"uuid"},"versionNumber":{"type":"integer","format":"int64"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"title":{"type":"string"},"language":{"type":"string"},"classification":{"type":"string","enum":["PUBLIC","INTERNAL","CONFIDENTIAL","RESTRICTED"]},"contentDigest":{"type":"string"}}},"Entity":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"type":{"type":"string"},"description":{"type":"string"},"citationChunkIds":{"type":"array","items":{"type":"string","format":"uuid"}},"governingEvidence":{"$ref":"#/components/schemas/EvidenceReference"}}},"KnowledgeGraphView":{"type":"object","properties":{"knowledgeSpaceId":{"type":"string","format":"uuid"},"authorizationGeneration":{"type":"integer","format":"int64"},"canCurate":{"type":"boolean"},"entities":{"type":"array","items":{"$ref":"#/components/schemas/Entity"}},"relations":{"type":"array","items":{"$ref":"#/components/schemas/Relation"}},"truncated":{"type":"boolean"}}},"Relation":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"sourceEntityId":{"type":"string","format":"uuid"},"targetEntityId":{"type":"string","format":"uuid"},"type":{"type":"string"},"description":{"type":"string"},"weight":{"type":"number","format":"double"},"keywords":{"type":"array","items":{"type":"string"}},"citationChunkIds":{"type":"array","items":{"type":"string","format":"uuid"}},"governingEvidence":{"$ref":"#/components/schemas/EvidenceReference"}}},"KnowledgeSpaceResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"key":{"type":"string"},"name":{"type":"string"},"departmentId":{"type":"string","format":"uuid"}}},"CitationEvidenceExcerpt":{"type":"object","properties":{"title":{"type":"string"},"heading":{"type":"string"},"startPage":{"type":"integer","format":"int32"},"endPage":{"type":"integer","format":"int32"},"excerpt":{"type":"string"},"truncated":{"type":"boolean"},"presentationKind":{"type":"string","enum":["PDF","MARKDOWN","PLAIN_TEXT","IMAGE","DOWNLOAD"]}}},"WorkInstructionToolResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"instruction":{"$ref":"#/components/schemas/WorkInstructionView"}}},"AssistantReleaseRef":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"releaseDigest":{"type":"string"}}},"PromptFormResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"release":{"$ref":"#/components/schemas/AssistantReleaseRef"},"objective":{"type":"string"},"audience":{"type":"string"},"variables":{"type":"array","items":{"$ref":"#/components/schemas/Variable"}},"outputContract":{"type":"object","additionalProperties":{}},"knowledgeRequirements":{"type":"array","items":{"type":"string"}},"knownLimitations":{"type":"string"}}},"Variable":{"type":"object","properties":{"name":{"type":"string"},"type":{"type":"string","enum":["STRING","INTEGER","NUMBER","BOOLEAN","STRING_LIST"]},"required":{"type":"boolean"},"defaultValue":{},"sensitive":{"type":"boolean"},"pattern":{"type":"string"},"allowedValues":{"type":"array","items":{"type":"string"}}}},"AssetRecommendation":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]},"namespace":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"portfolioState":{"type":"string","enum":["DRAFT_ONLY","ACTIVE","SUNSETTING","RETIRED"]},"releaseId":{"type":"string","format":"uuid"},"versionLabel":{"type":"string"},"releaseDigest":{"type":"string"},"availability":{"type":"string","enum":["AVAILABLE","DEPRECATED","WITHDRAWN"]},"releasedAt":{"type":"string","format":"date-time"}}},"RecommendationResult":{"type":"object","properties":{"traceId":{"type":"string","format":"uuid"},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/AssetRecommendation"}}}},"AssistantStarterPrompt":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"prompt":{"type":"string"}}},"AssistantModelOptionResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"gatewayLabel":{"type":"string"},"provider":{"type":"string"},"modelId":{"type":"string"},"displayName":{"type":"string"},"defaultChoice":{"type":"boolean"}}},"AssistantModelOptionsResponse":{"type":"object","properties":{"selectedModelActivationId":{"type":"string","format":"uuid"},"options":{"type":"array","items":{"$ref":"#/components/schemas/AssistantModelOptionResponse"}}}},"AssistantCitationResponse":{"type":"object","properties":{"citationNumber":{"type":"integer","format":"int32"},"sourceId":{"type":"string"},"title":{"type":"string"},"heading":{"type":"string"},"startPage":{"type":"integer","format":"int32"},"endPage":{"type":"integer","format":"int32"},"excerptUrl":{"type":"string"},"contentUrl":{"type":"string"}}},"AssistantConversationSummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"lastActivityAt":{"type":"string","format":"date-time"},"messageCount":{"type":"integer","format":"int64"}}},"AssistantConversationMessageView":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"role":{"type":"string","enum":["USER","ASSISTANT"]},"content":{"type":"string"},"sequence":{"type":"integer","format":"int64"},"occurredAt":{"type":"string","format":"date-time"},"feedback":{"type":"string","enum":["HELPFUL","NOT_HELPFUL"]}}},"AssetSummary":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]},"namespace":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"knowledgeSpaceId":{"type":"string","format":"uuid"},"portfolioState":{"type":"string","enum":["DRAFT_ONLY","ACTIVE","SUNSETTING","RETIRED"]},"updatedAt":{"type":"string","format":"date-time"}}},"File":{"type":"object","properties":{"path":{"type":"string"},"size":{"type":"integer","format":"int64"},"sha256":{"type":"string"}}},"SkillInstallManifest":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"namespace":{"type":"string"},"slug":{"type":"string"},"coordinate":{"type":"string"},"version":{"type":"string"},"publicationMode":{"type":"string","enum":["REVIEWED","DIRECT"]},"title":{"type":"string"},"description":{"type":"string"},"releaseDigest":{"type":"string"},"packageDigest":{"type":"string"},"packageLength":{"type":"integer","format":"int64"},"mediaType":{"type":"string"},"license":{"type":"string"},"compatibility":{"type":"string"},"allowedTools":{"type":"string"},"metadata":{"type":"object","additionalProperties":{"type":"string"}},"files":{"type":"array","items":{"$ref":"#/components/schemas/File"}}}},"CapabilityPackDefinition":{"type":"object","properties":{"packAssetId":{"type":"string","format":"uuid"},"packReleaseId":{"type":"string","format":"uuid"},"releaseDigest":{"type":"string"},"title":{"type":"string"},"versionLabel":{"type":"string"},"purpose":{"type":"string","enum":["ROLE_ONBOARDING","HANDOVER","ROLE_ENABLEMENT"]},"audience":{"type":"string"},"prerequisites":{"type":"array","items":{"type":"string"}},"expectedOutcome":{"type":"string"},"completionCriteria":{"type":"array","items":{"type":"string"}},"reviewDate":{"type":"string"},"owner":{"type":"string"},"accessGap":{"type":"boolean"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Item"}}}},"AssetGovernanceActions":{"type":"object","properties":{"canEdit":{"type":"boolean"},"canSubmitReview":{"type":"boolean"},"canReview":{"type":"boolean"},"canApprove":{"type":"boolean"},"canRequestChanges":{"type":"boolean"},"canReject":{"type":"boolean"},"canCancel":{"type":"boolean"},"canPublish":{"type":"boolean"},"canPublishSkill":{"type":"boolean"},"canWithdraw":{"type":"boolean"},"canOpenGovernance":{"type":"boolean"}}},"ConnectionOption":{"type":"object","properties":{"key":{"type":"string"}}},"AssetSummaryPage":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AssetSummary"}},"total":{"type":"integer","format":"int64"},"page":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"totalPages":{"type":"integer","format":"int32"},"sort":{"type":"string","enum":["RECENTLY_UPDATED","NAME"]}}},"AssetRecommendationPage":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/AssetRecommendation"}},"total":{"type":"integer","format":"int64"},"page":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"totalPages":{"type":"integer","format":"int32"},"sort":{"type":"string","enum":["RECENTLY_RELEASED","NAME"]}}},"AssetDeliveryRelease":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"type":{"type":"string","enum":["PROMPT_TEMPLATE","WORK_INSTRUCTION","CAPABILITY_PACK","SKILL"]},"namespace":{"type":"string"},"slug":{"type":"string"},"versionLabel":{"type":"string"},"publicationMode":{"type":"string","enum":["REVIEWED","DIRECT"]},"title":{"type":"string"},"summary":{"type":"string"},"classification":{"type":"string"},"schemaVersion":{"type":"string"},"payload":{"type":"string"},"digest":{"type":"string"},"availability":{"type":"string","enum":["AVAILABLE","DEPRECATED","WITHDRAWN"]},"releasedAt":{"type":"string","format":"date-time"}}},"AssetRelationResolution":{"type":"object","properties":{"assetId":{"type":"string","format":"uuid"},"releaseId":{"type":"string","format":"uuid"},"accessGap":{"type":"boolean"},"relations":{"type":"array","items":{"$ref":"#/components/schemas/Relation"}}}},"EffectivePermissionResponse":{"type":"object","properties":{"userId":{"type":"string","format":"uuid"},"permissions":{"type":"object","additionalProperties":{"type":"string","enum":["ALLOWED","DENIED","UNKNOWN"]}},"evaluatedAt":{"type":"string","format":"date-time"}}},"AdminSourceGroupMemberResponse":{"type":"object","properties":{"principalId":{"type":"string","format":"uuid"},"nativePrincipalId":{"type":"string"},"observedDisplayName":{"type":"string"},"observedEmail":{"type":"string"},"appUserId":{"type":"string","format":"uuid"},"appUserName":{"type":"string"}}},"AdminSourceGroupResponse":{"type":"object","properties":{"principalId":{"type":"string","format":"uuid"},"sourceSystem":{"type":"string"},"sourceConnectionKey":{"type":"string"},"nativePrincipalId":{"type":"string"},"observedDisplayName":{"type":"string"},"membershipSnapshotId":{"type":"string","format":"uuid"},"membershipGeneration":{"type":"integer","format":"int64"},"sealedAt":{"type":"string","format":"date-time"},"members":{"type":"array","items":{"$ref":"#/components/schemas/AdminSourceGroupMemberResponse"}}}},"AdminRoleListResponse":{"type":"object","properties":{"roles":{"type":"array","items":{"$ref":"#/components/schemas/AdminRoleResponse"}},"complete":{"type":"boolean"},"policyVersion":{"type":"string"}}},"AdminRoleResponse":{"type":"object","properties":{"role":{"type":"string"},"assignees":{"type":"array","items":{"type":"string"}}}},"CredentialResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"publicTokenId":{"type":"string"},"verifierKeyVersion":{"type":"integer","format":"int32"},"usersScope":{"type":"boolean"},"groupsScope":{"type":"boolean"},"expiresAt":{"type":"string","format":"date-time"},"overlapEndsAt":{"type":"string","format":"date-time"},"revokedAt":{"type":"string","format":"date-time"},"lastUsedAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"}}},"KnowledgeSpaceGrantOptionResponse":{"type":"object","properties":{"relation":{"type":"string"},"kinds":{"type":"array","items":{"type":"string","enum":["ORGANIZATION","DEPARTMENT","DEPARTMENT_MANAGERS","ROLE","USER"]}},"roles":{"type":"array","items":{"type":"string"}}}},"AdminConnectorScopeResponse":{"type":"object","properties":{"key":{"type":"string"},"displayName":{"type":"string"},"reachable":{"type":"boolean"},"admissible":{"type":"boolean"},"instruction":{"type":"string"}}},"AdminComponentCheckpointResponse":{"type":"object","properties":{"component":{"type":"string"},"observedCursor":{"type":"string"},"captureStatus":{"type":"string"},"incompleteReason":{"type":"string"},"observedAt":{"type":"string","format":"date-time"},"lastSuccessfulCursor":{"type":"string"},"lastSuccessfulAt":{"type":"string","format":"date-time"}}},"AdminConnectionActivityResponse":{"type":"object","properties":{"sourceSystem":{"type":"string"},"sourceConnectionKey":{"type":"string"},"objectsTotal":{"type":"integer","format":"int64"},"objectsActive":{"type":"integer","format":"int64"},"objectsArchived":{"type":"integer","format":"int64"},"lastObjectAt":{"type":"string","format":"date-time"},"lastCrawlAt":{"type":"string","format":"date-time"},"componentCheckpoints":{"type":"array","items":{"$ref":"#/components/schemas/AdminComponentCheckpointResponse"}},"recentAttempts":{"type":"array","items":{"$ref":"#/components/schemas/AdminCrawlAttemptResponse"}}}},"AdminCrawlAttemptResponse":{"type":"object","properties":{"outcome":{"type":"string"},"objectsMaterialized":{"type":"integer","format":"int32"},"objectsRotated":{"type":"integer","format":"int32"},"objectsRematerialized":{"type":"integer","format":"int32"},"objectsRetired":{"type":"integer","format":"int32"},"objectsFailed":{"type":"integer","format":"int32"},"errorCode":{"type":"string"},"errorMessage":{"type":"string"},"attemptedAt":{"type":"string","format":"date-time"}}},"AdminConnectorSourceResponse":{"type":"object","properties":{"sourceSystem":{"type":"string"},"displayName":{"type":"string"}}},"ProviderPresetResponse":{"type":"object","properties":{"preset":{"type":"string","enum":["OPENAI","ANTHROPIC","NINE_ROUTER","OPENROUTER","LITELLM","OLLAMA","OPENAI_COMPATIBLE"]},"displayName":{"type":"string"},"vendorName":{"type":"string"},"category":{"type":"string","enum":["DIRECT_PROVIDER","GATEWAY_ROUTER","SELF_HOSTED_CUSTOM"]},"protocol":{"type":"string","enum":["OPENAI_COMPATIBLE","ANTHROPIC_MESSAGES"]},"defaultBaseUrl":{"type":"string"},"baseUrlEditable":{"type":"boolean"}}},"IndexSettingsResponse":{"type":"object","properties":{"embeddingProvider":{"type":"string"},"embeddingModel":{"type":"string"},"dimensions":{"type":"integer","format":"int32"},"distanceMetric":{"type":"string"},"managementMode":{"type":"string"},"editable":{"type":"boolean"},"lifecycleNote":{"type":"string"}}},"KnowledgeAssetRef":{"type":"object","properties":{"knowledgeAssetId":{"type":"string","format":"uuid"},"knowledgeAssetVersionId":{"type":"string","format":"uuid"},"normalizedRecordId":{"type":"string","format":"uuid"},"rawSourceObjectId":{"type":"string","format":"uuid"},"sourceAclSnapshotId":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["PENDING","ACTIVE","RETIRED"]}}}}}} \ No newline at end of file From 9dba11fac42e57f27d71f838b95bd57779683f4b Mon Sep 17 00:00:00 2001 From: kl3inIT Date: Fri, 7 Aug 2026 09:05:36 +0000 Subject: [PATCH 2/2] fix(docs): refresh assistant request contract --- apps/docs/generated/openapi.public.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/apps/docs/generated/openapi.public.json b/apps/docs/generated/openapi.public.json index 6da6db55..01b56890 100644 --- a/apps/docs/generated/openapi.public.json +++ b/apps/docs/generated/openapi.public.json @@ -7303,7 +7303,7 @@ "properties": { "message": { "type": "string", - "maxLength": 4000, + "maxLength": 1000, "minLength": 0 }, "limit": {