generated: '2026-10-09' method: generated source: openapi/instill-ai-openapi.yml description: Recommended x-agentic-access execution contracts, classified heuristically from the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind audience per deployment. See research/curity/agentic-governance/. summary: operations: 102 by_action_class: connected: 52 acting: 50 by_consequence: read: 52 write: 50 human_in_the_loop_required: 0 operations: - path: /v1alpha/{parent}/knowledge-bases method: get operationId: ArtifactPublicService_ListKnowledgeBases x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{parent}/knowledge-bases method: post operationId: ArtifactPublicService_CreateKnowledgeBase x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{name} method: get operationId: ArtifactPublicService_GetKnowledgeBase x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{name} method: delete operationId: ArtifactPublicService_DeleteKnowledgeBase x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{name} method: patch operationId: ArtifactPublicService_UpdateChunk x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{knowledgeBase.name} method: patch operationId: ArtifactPublicService_UpdateKnowledgeBase x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{parent}/files method: get operationId: ArtifactPublicService_ListFiles x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{parent}/files method: post operationId: ArtifactPublicService_CreateFile x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{name_1} method: get operationId: ArtifactPublicService_GetFile x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{name_1} method: delete operationId: ArtifactPublicService_DeleteFile x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{file.name} method: patch operationId: ArtifactPublicService_UpdateFile x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{name}/reprocess method: post operationId: ArtifactPublicService_ReprocessFile x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{name_2} method: get operationId: ArtifactPublicService_GetChunk x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{name_2} method: delete operationId: ArtifactPublicService_DeleteObject x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{parent}/chunks method: get operationId: ArtifactPublicService_ListChunks x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{parent}/search-chunks method: post operationId: ArtifactPublicService_SearchChunks x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{parent}/object-upload-url method: get operationId: ArtifactPublicService_GetObjectUploadURL x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{name}/download-url method: get operationId: ArtifactPublicService_GetObjectDownloadURL x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{name_3} method: get operationId: ArtifactPublicService_GetObject x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{name_3} method: delete operationId: ModelPublicService_DeleteModel x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{object.name} method: patch operationId: ArtifactPublicService_UpdateObject x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/user method: get operationId: MgmtPublicService_GetAuthenticatedUser x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/user method: patch operationId: MgmtPublicService_PatchAuthenticatedUser x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/users method: get operationId: MgmtPublicService_ListUsers x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{name} method: get operationId: MgmtPublicService_GetUser x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{name} method: delete operationId: MgmtPublicService_DeleteToken x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/tokens method: get operationId: MgmtPublicService_ListTokens x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/tokens method: post operationId: MgmtPublicService_CreateToken x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name_1} method: get operationId: MgmtPublicService_GetToken x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{name_1} method: delete operationId: MgmtPublicService_DeleteNamespaceConnection x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/validate-token method: post operationId: MgmtPublicService_ValidateToken x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/check-namespace method: post operationId: MgmtPublicService_CheckNamespace x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/pipeline-runs/query-charts method: get operationId: MgmtPublicService_ListPipelineTriggerChartRecords x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/model-runs/query-charts method: get operationId: MgmtPublicService_ListModelTriggerChartRecords x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{parent}/connections method: get operationId: MgmtPublicService_ListNamespaceConnections x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{parent}/connections method: post operationId: MgmtPublicService_CreateNamespaceConnection x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name_2} method: get operationId: MgmtPublicService_GetNamespaceConnection x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{name_2} method: delete operationId: PipelinePublicService_DeletePipeline x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{connection.name} method: patch operationId: MgmtPublicService_UpdateNamespaceConnection x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name}/test method: post operationId: MgmtPublicService_TestNamespaceConnection x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/namespaces/{namespaceId}/connections/{connectionId}/referenced-pipelines method: get operationId: MgmtPublicService_ListPipelineIDsByConnectionID x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/integrations method: get operationId: PipelinePublicService_ListIntegrations x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/integrations/{integrationId} method: get operationId: MgmtPublicService_GetIntegration x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/model-definitions method: get operationId: ModelPublicService_ListModelDefinitions x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/available-regions method: get operationId: ModelPublicService_ListAvailableRegions x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/model-definitions/{modelDefinitionId} method: get operationId: ModelPublicService_GetModelDefinition x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/models method: get operationId: ModelPublicService_ListPublicModels x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{parent}/models method: get operationId: ModelPublicService_ListModels x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{parent}/models method: post operationId: ModelPublicService_CreateModel x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{name_4} method: get operationId: ModelPublicService_GetModel x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{name_4} method: delete operationId: ModelPublicService_DeleteModelVersion x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{model.name} method: patch operationId: ModelPublicService_UpdateModel x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{name}/rename method: post operationId: ModelPublicService_RenameModel x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{name}/versions/{version}/watch method: get operationId: ModelPublicService_WatchModelVersion x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{name}/watch method: get operationId: ModelPublicService_WatchModel x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{parent}/versions method: get operationId: ModelPublicService_ListModelVersions x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{name}/trigger method: post operationId: ModelPublicService_TriggerModelVersion x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{name}/trigger-async method: post operationId: ModelPublicService_TriggerAsyncModelVersion x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{name_1}/trigger method: post operationId: ModelPublicService_TriggerModel x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{name_1}/trigger-async method: post operationId: ModelPublicService_TriggerAsyncModel x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1alpha/{name}/operation method: get operationId: ModelPublicService_GetModelVersionOperation x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{name_1}/operation method: get operationId: ModelPublicService_GetModelOperation x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/operations/{operationId} method: get operationId: ModelPublicService_GetOperation x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/{parent}/runs method: get operationId: ModelPublicService_ListModelRuns x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1alpha/dashboard/models/runs method: get operationId: ModelPublicService_ListModelRunsByRequester x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/pipelines method: get operationId: PipelinePublicService_ListPublicPipelines x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{parent}/pipelines method: get operationId: PipelinePublicService_ListPipelines x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{parent}/pipelines method: post operationId: PipelinePublicService_CreatePipeline x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name_3} method: get operationId: PipelinePublicService_GetPipeline x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{name_3} method: delete operationId: PipelinePublicService_DeletePipelineRelease x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{pipeline.name} method: patch operationId: PipelinePublicService_UpdatePipeline x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name}/validate method: post operationId: PipelinePublicService_ValidatePipeline x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name}/rename method: post operationId: PipelinePublicService_RenamePipeline x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name}/clone method: post operationId: PipelinePublicService_ClonePipeline x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name}/trigger method: post operationId: PipelinePublicService_TriggerPipeline x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name}/trigger-stream method: post operationId: PipelinePublicService_TriggerPipelineWithStream x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name}/trigger-async method: post operationId: PipelinePublicService_TriggerAsyncPipeline x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{parent}/releases method: get operationId: PipelinePublicService_ListPipelineReleases x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{parent}/releases method: post operationId: PipelinePublicService_CreatePipelineRelease x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name_4} method: get operationId: PipelinePublicService_GetPipelineRelease x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{name_4} method: delete operationId: PipelinePublicService_DeleteNamespaceSecret x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{release.name} method: patch operationId: PipelinePublicService_UpdatePipelineRelease x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name_1}/clone method: post operationId: PipelinePublicService_ClonePipelineRelease x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name_1}/trigger method: post operationId: PipelinePublicService_TriggerPipelineRelease x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name_1}/trigger-async method: post operationId: PipelinePublicService_TriggerAsyncPipelineRelease x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{parent}/secrets method: get operationId: PipelinePublicService_ListNamespaceSecrets x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{parent}/secrets method: post operationId: PipelinePublicService_CreateNamespaceSecret x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name_5} method: get operationId: PipelinePublicService_GetNamespaceSecret x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{name_5} method: delete operationId: PipelinePublicService_DeleteConnection x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{secret.name} method: patch operationId: PipelinePublicService_UpdateNamespaceSecret x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/component-definitions method: get operationId: PipelinePublicService_ListComponentDefinitions x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/operations/{operationId} method: get operationId: PipelinePublicService_GetOperation x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{parent}/runs method: get operationId: PipelinePublicService_ListPipelineRuns x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{parent}/component-runs method: get operationId: PipelinePublicService_ListComponentRuns x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/dashboard/pipelines/runs method: get operationId: PipelinePublicService_ListPipelineRunsByRequester x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/integrations/{integrationId_1} method: get operationId: PipelinePublicService_GetIntegration x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{parent_1}/connections method: get operationId: PipelinePublicService_ListConnections x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{parent_1}/connections method: post operationId: PipelinePublicService_CreateConnection x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name_6} method: get operationId: PipelinePublicService_GetConnection x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1beta/{connection.name_1} method: patch operationId: PipelinePublicService_UpdateConnection x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/{name_1}/test method: post operationId: PipelinePublicService_TestConnection x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1beta/namespaces/{namespaceId_1}/connections/{connectionId}/referenced-pipelines method: get operationId: PipelinePublicService_ListPipelineIDsByConnectionID x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none