generated: '2026-07-15' method: generated source: openapi/datafold-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: 52 by_action_class: connected: 23 acting: 29 by_consequence: read: 23 write: 29 human_in_the_loop_required: 0 operations: - path: /api/internal/bolt/org/spend method: get operationId: get_org_spend_api_internal_bolt_org_spend_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/audit_logs method: get operationId: get_audit_logs_api_v1_audit_logs_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/ci/{ci_config_id}/runs method: get operationId: get_ci_api_v1_ci__ci_config_id__runs_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/ci/{ci_config_id}/trigger method: post operationId: trigger_ci_api_v1_ci__ci_config_id__trigger_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: /api/v1/ci/{ci_config_id}/{pr_num} method: post operationId: upload_changes_api_v1_ci__ci_config_id___pr_num__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: /api/v1/data_sources method: get operationId: list_data_sources_api_v1_data_sources_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/data_sources method: post operationId: create_new_datasource_api_v1_data_sources_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: /api/v1/data_sources/test/{job_id} method: get operationId: get_data_source_test_result_api_v1_data_sources_test__job_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/data_sources/types method: get operationId: get_data_source_types_api_v1_data_sources_types_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/data_sources/{data_source_id} method: get operationId: get_data_source_api_v1_data_sources__data_source_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/data_sources/{data_source_id}/query method: post operationId: execute_query_api_v1_data_sources__data_source_id__query_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: /api/v1/data_sources/{data_source_id}/summary method: get operationId: get_data_source_summary_api_v1_data_sources__data_source_id__summary_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/data_sources/{data_source_id}/test method: post operationId: test_data_source_api_v1_data_sources__data_source_id__test_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: /api/v1/datadiffs method: get operationId: list_datadiffs_api_v1_datadiffs_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/datadiffs method: post operationId: create_datadiff_api_v1_datadiffs_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: /api/v1/datadiffs/{datadiff_id} method: get operationId: get_datadiff_api_v1_datadiffs__datadiff_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/datadiffs/{datadiff_id} method: patch operationId: update_datadiff_api_v1_datadiffs__datadiff_id__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: /api/v1/datadiffs/{datadiff_id}/cancel method: post operationId: cancel_diff_api_v1_datadiffs__datadiff_id__cancel_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: /api/v1/datadiffs/{datadiff_id}/summary method: get operationId: get_diff_summary_api_v1_datadiffs__datadiff_id__summary_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/datadiffs/{datadiff_id}/summary_results method: get operationId: get_diff_summary_v1_api_v1_datadiffs__datadiff_id__summary_results_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/explore/db/{data_connection_id}/columns/{column_path}/downstreams method: get operationId: db_column_downstreams_api_v1_explore_db__data_connection_id__columns__column_path__downstreams_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/explore/db/{data_connection_id}/columns/{column_path}/upstreams method: get operationId: db_column_upstreams_api_v1_explore_db__data_connection_id__columns__column_path__upstreams_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/explore/db/{data_connection_id}/tables/{table_path}/downstreams method: get operationId: db_table_downstreams_api_v1_explore_db__data_connection_id__tables__table_path__downstreams_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/explore/db/{data_connection_id}/tables/{table_path}/upstreams method: get operationId: db_table_upstreams_api_v1_explore_db__data_connection_id__tables__table_path__upstreams_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/lineage/bi/ method: get operationId: get_all_integrations_api_v1_lineage_bi__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/lineage/bi/dbt/ method: post operationId: create_dbt_integration_api_v1_lineage_bi_dbt__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: /api/v1/lineage/bi/dbt/{bi_datasource_id}/ method: put operationId: update_dbt_integration_api_v1_lineage_bi_dbt__bi_datasource_id___put 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: /api/v1/lineage/bi/hightouch/ method: post operationId: create_hightouch_integration_api_v1_lineage_bi_hightouch__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: /api/v1/lineage/bi/hightouch/{bi_datasource_id}/ method: put operationId: change_hightouch_integration_api_v1_lineage_bi_hightouch__bi_datasource_id___put 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: /api/v1/lineage/bi/looker/ method: post operationId: create_looker_integration_api_v1_lineage_bi_looker__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: /api/v1/lineage/bi/looker/{bi_datasource_id}/ method: put operationId: update_looker_integration_api_v1_lineage_bi_looker__bi_datasource_id___put 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: /api/v1/lineage/bi/mode/ method: post operationId: create_mode_integration_api_v1_lineage_bi_mode__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: /api/v1/lineage/bi/mode/{bi_datasource_id}/ method: put operationId: change_mode_integration_api_v1_lineage_bi_mode__bi_datasource_id___put 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: /api/v1/lineage/bi/powerbi/ method: post operationId: create_powerbi_integration_api_v1_lineage_bi_powerbi__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: /api/v1/lineage/bi/powerbi/{bi_datasource_id}/ method: put operationId: update_powerbi_integration_api_v1_lineage_bi_powerbi__bi_datasource_id___put 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: /api/v1/lineage/bi/tableau/ method: post operationId: create_tableau_integration_api_v1_lineage_bi_tableau__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: /api/v1/lineage/bi/tableau/{bi_datasource_id}/ method: put operationId: update_tableau_integration_api_v1_lineage_bi_tableau__bi_datasource_id___put 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: /api/v1/lineage/bi/{bi_datasource_id}/ method: delete operationId: remove_integration_api_v1_lineage_bi__bi_datasource_id___delete 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: /api/v1/lineage/bi/{bi_datasource_id}/ method: get operationId: get_integration_api_v1_lineage_bi__bi_datasource_id___get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/lineage/bi/{bi_datasource_id}/sync/ method: get operationId: resync_integration_api_v1_lineage_bi__bi_datasource_id__sync__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/monitors method: get operationId: list_monitors_api_v1_monitors_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/monitors/create/diff method: post operationId: create_monitor_diff_api_v1_monitors_create_diff_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: /api/v1/monitors/create/metric method: post operationId: create_monitor_metric_api_v1_monitors_create_metric_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: /api/v1/monitors/create/schema method: post operationId: create_monitor_schema_api_v1_monitors_create_schema_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: /api/v1/monitors/create/test method: post operationId: create_monitor_test_api_v1_monitors_create_test_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: /api/v1/monitors/{id} method: delete operationId: delete_monitor_api_v1_monitors__id__delete 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: /api/v1/monitors/{id} method: get operationId: get_monitor_api_v1_monitors__id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/monitors/{id}/run method: post operationId: start_monitor_run_api_v1_monitors__id__run_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: /api/v1/monitors/{id}/runs method: get operationId: list_monitor_runs_api_v1_monitors__id__runs_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/monitors/{id}/runs/{run_id} method: get operationId: get_monitor_run_api_v1_monitors__id__runs__run_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/monitors/{id}/toggle method: put operationId: toggle_monitor_on_off_api_v1_monitors__id__toggle_put 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: /api/v1/monitors/{id}/update method: patch operationId: update_monitor_api_v1_monitors__id__update_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