NationGraph · Agentic Access

NationGraph Agentic Access

x-agentic-access generated

NationGraph exposes 253 API operations that an AI agent could call, of which 136 are state-changing ‘acting’ operations. This is a recommended x-agentic-access execution contract — the scope, audience, consequence tier, short-lived token constraints, and escalation each action should carry before it is handed to an autonomous agent.

By consequence: 117 read, 134 write, and 2 physical.

Contracts are classified heuristically from the provider’s OpenAPI and refresh on every APIs.io network build; audience is bound per deployment. The model follows Curity’s Access Intelligence (apidays Munich 2026). Browse every provider’s agent contracts at agentic-access.apis.io.

CompanySales IntelligencePublic SectorGovernmentSLEDGovTechProcurementRFPDataSales
Operations: 253 Acting: 136 Human-in-the-loop: 0 Method: generated

By consequence

read 117 write 134 physical 2

Highest-consequence actions

The physical and safety-critical operations an agent could invoke — the ones that most warrant scoped tokens, tight TTLs, and escalation. Full per-operation contracts are in the source below.

MethodPathConsequenceHuman-in-loop
POST /api/internal/purchase-orders/search physical conditional
POST /api/v3/export/workspaces/{workspace_id}/purchase_orders physical conditional

Source

Agentic Access

Raw ↑ 
generated: '2026-07-20'
method: generated
source: openapi/nationgraph-openapi-original.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: 253
  by_action_class:
    connected: 117
    acting: 136
  by_consequence:
    read: 117
    write: 134
    physical: 2
  human_in_the_loop_required: 0
operations:
- path: /api/v3/workspaces/institutions
  method: get
  operationId: get_institutions_in_workspace_api_v3_workspaces_institutions_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/workspaces/{workspace_id}/institutions
  method: post
  operationId: add_institution_to_workspace_api_v3_workspaces__workspace_id__institutions_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/v3/workspaces/{workspace_id}/institutions
  method: delete
  operationId: delete_workspace_institutions_api_v3_workspaces__workspace_id__institutions_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/v3/workspaces/{workspace_id}/institutions
  method: get
  operationId: get_workspace_institutions_api_v3_workspaces__workspace_id__institutions_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/institutions/count
  method: post
  operationId: get_institution_count_api_v3_institutions_count_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/v3/institutions/metadata
  method: post
  operationId: get_institution_metadata_api_v3_institutions_metadata_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/v3/institutions
  method: get
  operationId: get_institutions_api_v3_institutions_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/institutions/{institution_id}
  method: get
  operationId: get_institution_api_v3_institutions__institution_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/workspaces/{workspace_id}/institution/{institution_id}/notes
  method: post
  operationId: insert_note_api_v3_workspaces__workspace_id__institution__institution_id__notes_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/v3/workspaces/{workspace_id}/institution/{institution_id}/notes
  method: get
  operationId: get_notes_by_institution_api_v3_workspaces__workspace_id__institution__institution_id__notes_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/notes
  method: put
  operationId: update_note_api_v3_notes_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/v3/notes/{note_id}
  method: delete
  operationId: delete_note_api_v3_notes__note_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/v3/summary/generate-email
  method: post
  operationId: generate_email_api_v3_summary_generate_email_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/v3/summary/workspaces/{workspace_id}/institution/{institution_id}/custom
  method: get
  operationId: get_cells_by_institution_api_v3_summary_workspaces__workspace_id__institution__institution_id__custom_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/summary/enrich-prompt
  method: post
  operationId: enrich_prompt_api_v3_summary_enrich_prompt_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/v3/summary/generate-call-script
  method: post
  operationId: generate_call_script_api_v3_summary_generate_call_script_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/v3/workspaces
  method: get
  operationId: get_workspaces_api_v3_workspaces_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/workspaces/{workspace_id}
  method: get
  operationId: get_workspace_api_v3_workspaces__workspace_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/workspaces/{workspace_id}
  method: patch
  operationId: edit_workspace_api_v3_workspaces__workspace_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/v3/workspaces/{workspace_id}
  method: delete
  operationId: delete_workspace_api_v3_workspaces__workspace_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/v3/workspaces/{workspace_id}/duplicate
  method: post
  operationId: duplicate_workspace_api_v3_workspaces__workspace_id__duplicate_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/v3/workspaces/create
  method: post
  operationId: create_new_workspace_api_v3_workspaces_create_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/v3/workspaces/preview
  method: post
  operationId: preview_institutions_api_v3_workspaces_preview_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/v3/workspaces/{workspace_id}/smart-columns
  method: post
  operationId: upsert_smart_column_api_v3_workspaces__workspace_id__smart_columns_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/v3/workspaces/{workspace_id}/smart-columns/{column_id}/rerun
  method: post
  operationId: rerun_smart_column_api_v3_workspaces__workspace_id__smart_columns__column_id__rerun_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/v3/workspaces/{workspace_id}/smart-columns/{column_id}
  method: patch
  operationId: patch_smart_column_endpoint_api_v3_workspaces__workspace_id__smart_columns__column_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/v3/workspaces/{workspace_id}/institutions/{institution_id}/smart-columns
  method: post
  operationId: process_smart_columns_for_institution_api_v3_workspaces__workspace_id__institutions__institution_id__smart_columns_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/v3/workspaces/{workspace_id}/custom-column/{column_id}
  method: delete
  operationId: delete_custom_column_api_v3_workspaces__workspace_id__custom_column__column_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/v3/workspaces/{workspace_id}/custom-column/{column_id}
  method: get
  operationId: get_custom_column_api_v3_workspaces__workspace_id__custom_column__column_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/enrich-keywords
  method: post
  operationId: enrich_keywords_api_v3_enrich_keywords_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/v3/enrich-prompt
  method: post
  operationId: enrich_prompt_api_v3_enrich_prompt_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/v3/rag/data_source/{data_source}/documents/{document_id}
  method: get
  operationId: get_rag_document_api_v3_rag_data_source__data_source__documents__document_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/export/workspaces/{workspace_id}
  method: post
  operationId: export_workspace_csv_api_v3_export_workspaces__workspace_id__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/v3/export/institution/{institution_id}/purchase_orders/column/{column_id}
  method: get
  operationId: export_single_po_csv_api_v3_export_institution__institution_id__purchase_orders_column__column_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/export/workspaces/{workspace_id}/purchase_orders
  method: post
  operationId: export_po_csv_api_v3_export_workspaces__workspace_id__purchase_orders_post
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v3/export/rfps
  method: post
  operationId: export_rfps_csv_api_v3_export_rfps_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/v3/export/grants
  method: post
  operationId: export_grants_csv_api_v3_export_grants_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/v3/export/workspaces/{workspace_id}/contacts
  method: post
  operationId: export_contacts_csv_api_v3_export_workspaces__workspace_id__contacts_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/v3/webhooks/clerk
  method: post
  operationId: webhook_clerk_api_v3_webhooks_clerk_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/v3/org-admin/signal-settings
  method: get
  operationId: list_org_signal_settings_api_v3_org_admin_signal_settings_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/org-admin/signal-settings/copy
  method: post
  operationId: copy_signal_settings_to_recipients_api_v3_org_admin_signal_settings_copy_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/v3/intent/get-company-info
  method: post
  operationId: get_company_info_api_v3_intent_get_company_info_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/v3/intent/create-company-rubrics
  method: post
  operationId: create_company_rubrics_api_v3_intent_create_company_rubrics_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/v3/workspaces/{workspace_id}/institution/{institution_id}/unified-insights
  method: get
  operationId: get_unified_insights_api_v3_workspaces__workspace_id__institution__institution_id__unified_insights_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/workspaces/{workspace_id}/institution/{institution_id}/tags
  method: post
  operationId: create_tags_api_v3_workspaces__workspace_id__institution__institution_id__tags_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/v3/workspaces/{workspace_id}/institution/{institution_id}/tags
  method: put
  operationId: update_tags_api_v3_workspaces__workspace_id__institution__institution_id__tags_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/v3/tags
  method: post
  operationId: persist_new_tag_api_v3_tags_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/v3/workspaces/{workspace_id}/tags
  method: get
  operationId: get_workspace_tags_api_v3_workspaces__workspace_id__tags_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/workspaces/{workspace_id}/tags/{tag_id}
  method: delete
  operationId: delete_workspace_tag_api_v3_workspaces__workspace_id__tags__tag_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/v3/insights/{id}
  method: patch
  operationId: update_insight_api_v3_insights__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/v3/classifier/get-entity-ids
  method: post
  operationId: get_entity_ids_from_names_api_v3_classifier_get_entity_ids_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/v3/classifiers/institutions/match
  method: post
  operationId: match_institutions_api_v3_classifiers_institutions_match_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/v3/rfps/search
  method: post
  operationId: search_rfps_api_v3_rfps_search_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/v3/rfps/institutions
  method: get
  operationId: get_rfp_institutions_api_v3_rfps_institutions_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/rfps/{unique_id}
  method: get
  operationId: get_rfps_by_entity_api_v3_rfps__unique_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/lists
  method: get
  operationId: get_lists_api_v3_lists_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/lists
  method: post
  operationId: create_list_api_v3_lists_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/v3/lists/{list_id}
  method: patch
  operationId: edit_list_api_v3_lists__list_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/v3/lists/{list_id}
  method: delete
  operationId: delete_list_api_v3_lists__list_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/v3/lists/{list_id}/signals/{signal_id}
  method: post
  operationId: add_signal_to_list_api_v3_lists__list_id__signals__signal_id__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/v3/lists/{list_id}/signals/{signal_id}
  method: delete
  operationId: remove_signal_from_list_api_v3_lists__list_id__signals__signal_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/v3/lists/{list_id}/signals
  method: post
  operationId: batch_add_signals_to_list_api_v3_lists__list_id__signals_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/v3/lists/{list_id}/signals
  method: delete
  operationId: batch_remove_signals_from_list_api_v3_lists__list_id__signals_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/v3/lists/{list_id}/signals
  method: get
  operationId: get_signals_in_list_api_v3_lists__list_id__signals_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/metadata/{entity_id}
  method: get
  operationId: get_entity_metadata_api_v3_metadata__entity_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/user-profiles/{user_id}
  method: get
  operationId: get_user_profile_api_v3_user_profiles__user_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/user-profiles/{user_id}
  method: patch
  operationId: update_user_profile_api_v3_user_profiles__user_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/v3/user-profiles/documents/search
  method: post
  operationId: search_user_profile_documents_api_v3_user_profiles_documents_search_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/v3/user-profiles/{user_id}/document-summary
  method: post
  operationId: generate_user_document_summary_api_v3_user_profiles__user_id__document_summary_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/v3/signals/search
  method: post
  operationId: search_signals_api_v3_signals_search_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/v3/signals/{signal_id}
  method: get
  operationId: get_signal_api_v3_signals__signal_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/signals/{signal_id}/sources
  method: get
  operationId: get_signal_data_sources_api_v3_signals__signal_id__sources_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/signals/{signal_id}/users
  method: post
  operationId: add_user_to_signal_api_v3_signals__signal_id__users_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/v3/signals/{signal_id}/actions
  method: post
  operationId: create_signal_user_action_api_v3_signals__signal_id__actions_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/v3/signals/actions
  method: post
  operationId: batch_create_signal_user_actions_api_v3_signals_actions_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/v3/signals/{signal_id}/status
  method: patch
  operationId: update_signal_user_status_api_v3_signals__signal_id__status_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/v3/signals/status
  method: patch
  operationId: batch_update_signal_user_status_api_v3_signals_status_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/v3/signals/dismiss
  method: post
  operationId: dismiss_signals_api_v3_signals_dismiss_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/v3/signals/{signal_id}/share
  method: get
  operationId: create_signal_share_link_api_v3_signals__signal_id__share_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/signals/share/{signal_token}
  method: get
  operationId: get_shared_signal_api_v3_signals_share__signal_token__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/contacts
  method: get
  operationId: get_contacts_api_v3_contacts_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/contacts/search
  method: post
  operationId: search_contacts_api_v3_contacts_search_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/v3/rag/preprocess
  method: post
  operationId: preprocess_rag_query_api_v3_rag_preprocess_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/v3/rag/query
  method: post
  operationId: query_rag_data_api_v3_rag_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/v3/rag/query-direct
  method: post
  operationId: query_rag_direct_api_v3_rag_query_direct_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/v3/queue/stats
  method: get
  operationId: get_queue_stats_api_v3_queue_stats_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/signal-settings
  method: post
  operationId: create_signal_setting_api_v3_signal_settings_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/v3/signal-settings
  method: get
  operationId: get_signal_settings_api_v3_signal_settings_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v3/signal-settings/batch
  method: post
  operationId: batch_create_signal_settings_api_v3_signal_settings_batch_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/v3/signal-settings/users/{user_id}/stats
  method: get
  operatio

# --- truncated at 32 KB (85 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/nationgraph/refs/heads/main/agentic-access/nationgraph-agentic-access.yml