generated: '2026-08-13' method: generated source: openapi/airops-api-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: 42 by_action_class: connected: 13 acting: 29 by_consequence: read: 13 write: 28 safety-critical: 1 human_in_the_loop_required: 1 operations: - path: /public_api/airops_apps/executions/{execution_uuid} method: get operationId: getExecution x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /public_api/airops_apps/{app_uuid}/execute method: post operationId: executeApp 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: /public_api/airops_apps/{app_uuid}/async_execute method: post operationId: asyncExecuteApp 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: /public_api/airops_apps/{app_uuid}/webhook_async_execute method: post operationId: WebhookAsyncExecuteApp 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: /public_api/airops_apps/executions/{execution_uuid}/cancel method: patch 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: /public_api/airops_apps/executions/{execution_uuid}/retry method: post 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: /public_api/airops_apps/executions/{execution_uuid}/feedback method: patch 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: /public_api/airops_apps/:airops_app_id/executions method: get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /public_api/airops_apps method: get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /public_api/airops_apps/{app_uuid} method: get operationId: getApp x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /public_api/agent_apps/{app_uuid}/chat method: post operationId: chatWithAgent 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: /public_api/agent_apps/{app_uuid}/async_chat method: post operationId: asyncChatWithAgent 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: /public_api/workspace_files method: post operationId: workspaceFileUpload 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: /public_api/grids/{grid_id}/sheets/{sheet_id}/generate_csv method: post 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: /public_api/grids/{grid_id}/sheets/{sheet_id}/download_csv/latest method: get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /public_api/vector_stores/{memory_store_id}/search method: get operationId: searchMemoryStore x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /public_api/vector_stores/{memory_store_id}/vector_store_documents method: post operationId: addDocumentToMemoryStore 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: /public_api/vector_stores/{memory_store_id}/vector_store_documents/{memory_store_document_id} method: put operationId: updateDocumentInMemoryStore 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: /public_api/vector_stores/{memory_store_id}/vector_store_documents/{memory_store_document_id} method: delete operationId: deleteDocumentFromMemoryStore 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: /public_api/brand_kits/list method: post operationId: listBrandKits 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: /public_api/brand_kits/{brand_kit_id}/prompts/list method: post operationId: listBrandKitsPrompts 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: /public_api/brand_kits/{brand_kit_id}/prompts/{id} method: get operationId: getBrandKitsPrompt x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /public_api/brand_kits/{brand_kit_id}/topics/list method: post operationId: listBrandKitsTopics x-agentic-access: action-class: acting consequence: safety-critical subject: required audience: null token: max-ttl: 120 exchange: true purpose-required: true proof-of-possession: true escalation: human-in-the-loop: required audit: required - path: /public_api/brand_kits/{brand_kit_id}/topics/{id} method: get operationId: getBrandKitsTopic x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /public_api/brand_kits/{brand_kit_id}/personas/list method: post operationId: listBrandKitsPersonas 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: /public_api/brand_kits/{brand_kit_id}/personas/{id} method: get operationId: getBrandKitsPersona x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /public_api/brand_kits/{brand_kit_id}/citations/list method: post operationId: listBrandKitsCitations 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: /public_api/brand_kits/{brand_kit_id}/citations/show method: post operationId: getBrandKitsCitation 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: /public_api/brand_kits/{brand_kit_id}/competitors/list method: post operationId: listBrandKitsCompetitors 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: /public_api/brand_kits/{brand_kit_id}/competitors/{id} method: get operationId: getBrandKitsCompetitor x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /public_api/brand_kits/{brand_kit_id}/web_pages/list method: post operationId: listBrandKitsWebPages 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: /public_api/brand_kits/{brand_kit_id}/analytics method: post operationId: getBrandKitsAnalytic 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: /public_api/brand_kits/{id} method: get operationId: getBrandKit x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /public_api/brand_kits/{brand_kit_id}/sentiment_theme_answers method: post operationId: getBrandKitsSentimentThemeAnswer 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: /public_api/brand_kits/{brand_kit_id}/content_updates/list method: post operationId: listBrandKitsContentUpdates 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: /public_api/brand_kits/{brand_kit_id}/content_updates method: post operationId: createBrandKitsContentUpdates 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: /public_api/brand_kits/{brand_kit_id}/content_updates/{id} method: get operationId: getBrandKitsContentUpdate x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /public_api/brand_kits/{brand_kit_id}/content_updates/{id} method: delete operationId: destroyBrandKitsContentUpdates 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: /public_api/brand_kits/{brand_kit_id}/tags/list method: post operationId: listBrandKitsTags 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: /public_api/brand_kits/{brand_kit_id}/tags/{id} method: get operationId: getBrandKitsTag x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /public_api/brand_kits/{brand_kit_id}/answers/list method: post operationId: listBrandKitsAnswers 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: /public_api/brand_kits/{brand_kit_id}/answers/show method: post operationId: getBrandKitsAnswer 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