generated: '2026-08-14' method: generated source: openapi/bigtincan-hub-api-openapi.json 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: 69 by_action_class: connected: 33 acting: 36 by_consequence: read: 33 write: 35 safety-critical: 1 human_in_the_loop_required: 1 operations: - path: /v1/bookmarks method: get operationId: get-v1-bookmarks x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/channel/all method: get operationId: get-v1-channel-all x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/channels method: post operationId: post-v1-channels 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: /v1/admin/channels method: get operationId: get-v1-admin-channels x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/channel/{channel_id} method: delete operationId: delete-v1-channel-by-channel-id 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: /v1/channel/{channel_id} method: patch operationId: patch-v1-channel-by-channel-id 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: /v1/channel/personal/add method: post operationId: post-v1-channel-personal-add 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: /v1/admin/channels/{channel_id} method: patch operationId: patch-v1-admin-channels-by-channel-id 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: /v1/settings method: get operationId: get-v1-settings x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/events method: get operationId: get-v1-events x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/files/{file_perm_id}/tags method: post operationId: post-v1-files-by-file-perm-id-tags 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: /v1/files/{file_perm_id} method: get operationId: get-v1-files-by-file-perm-id x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/files method: get operationId: get-v1-files x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/file/allowed-extensions method: get operationId: get-v1-file-allowed-extensions x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/form_category/all method: get operationId: get-v1-form-category-all x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/form/all method: get operationId: get-v1-form-all x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/form/get/{form_id} method: get operationId: get-v1-form-get-by-form-id x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/form/data/{form_id} method: get operationId: get-v1-form-data-by-form-id x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/form/get_file/{form_id}/{submission_key}/{filename} method: get operationId: get-v1-form-get-file-by-form-id-by-submission-key-by-filename x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/group/all method: get operationId: get-v1-group-all x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/group method: post operationId: post-v1-group 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: /v1/admin/groups/{group_id} method: delete operationId: delete-v1-admin-groups-by-group-id 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: /v1/admin/groups/{group_id} method: patch operationId: patch-v1-admin-groups-by-group-id 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: /v1/group/{group_id}/users method: put operationId: put-v1-group-by-group-id-users 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: /v1/admin/group/get/{group_id} method: get operationId: get-v1-admin-group-get-by-group-id x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/admin/groups/{group_id}/users/{user_id} method: delete operationId: delete-v1-admin-groups-by-group-id-users-by-user-id 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: /v1/track_interactions method: post operationId: post-v1-track-interactions 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: /v1/links method: post operationId: post-v1-links 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: /v1/shares method: get operationId: get-v1-shares x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/shares method: post operationId: post-v1-shares 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: /v1/shares/{share_id} method: get operationId: get-v1-shares-by-share-id x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/shares/{share_id} method: delete operationId: delete-v1-shares-by-share-id 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: /v1/shares/{share_id}/files/{file_id} method: put operationId: put-v1-shares-by-share-id-files-by-file-id 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: /v1/shares/{share_id}/files/{file_id} method: delete operationId: delete-v1-shares-by-share-id-files-by-file-id 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: /v1/story/add/tag/{story_perm_id} method: post operationId: post-v1-story-add-tag-by-story-perm-id 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: /v1/story/archive/{revision_id} method: delete operationId: delete-v1-story-archive-by-revision-id 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: /v1/story/comment/{revision_id} method: post operationId: post-v1-story-comment-by-revision-id 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: /v1/story/crm/recommendation method: get operationId: get-v1-story-crm-recommendation x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/story/search method: get operationId: get-v1-story-search x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/story/share/{revision_id} method: post operationId: post-v1-story-share-by-revision-id 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: /v1/story/upload/file method: post operationId: post-v1-story-upload-file 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: /v1/story/{story_perm_id}/widgets method: get operationId: get-v1-story-by-story-perm-id-widgets x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/tab/all method: get operationId: get-v1-tab-all x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/admin/tabs method: get operationId: get-v1-admin-tabs x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/tab method: post operationId: post-v1-tab 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: /v1/tabs/{tab_id}/channels/{channel_id}/groups method: put operationId: put-v1-tabs-by-tab-id-channels-by-channel-id-groups 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: /v1/tabs/{tab_id}/channels/{channel_id}/groups/{group_id} method: delete operationId: delete-v1-tabs-by-tab-id-channels-by-channel-id-groups-by-group-id 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: /v1/tab/{tab_id} method: delete operationId: delete-v1-tab-by-tab-id 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: /v1/admin/tabs/{tab_id} method: patch operationId: patch-v1-admin-tabs-by-tab-id 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: /v1/tags method: get operationId: get-v1-tags x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/user/{user_id} method: delete operationId: delete-v1-user-by-user-id 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: /v1/user/change-password method: patch operationId: patch-v1-user-change-password 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: /v1/user/forgot-password method: patch operationId: patch-v1-user-forgot-password 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: /v1/user/me method: get operationId: get-v1-user-me x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/user-metadata method: get operationId: get-v1-user-metadata x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/user/{user_id}/metadata method: get operationId: get-v1-user-by-user-id-metadata x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/user/{user_id}/metadata method: patch operationId: patch-v1-user-by-user-id-metadata 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: /v1.1/channel method: post operationId: post-v1-1-channel 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: /v1.1/admin/group/all method: get operationId: get-v1-1-admin-group-all x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1.1/story/get/{story_perm_id} method: get operationId: get-v1-1-story-get-by-story-perm-id x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1.1/admin/user/get/{user_id} method: get operationId: get-v1-1-admin-user-get-by-user-id x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1.1/user method: post operationId: post-v1-1-user 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: /v1.1/user method: patch operationId: patch-v1-1-user 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: /v1.3/search/files method: get operationId: get-v1-3-search-files x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1.3/search/stories method: get operationId: get-v1-3-search-stories x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1.3/admin/user/all method: get operationId: get-v1-3-admin-user-all x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1.2/story/all method: get operationId: get-v1-2-story-all x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1.2/story/add method: post operationId: post-v1-2-story-add 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: /v1.2/story/edit/{revision_id} method: put operationId: put-v1-2-story-edit-by-revision-id 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