Seekr · Agentic Access

Seekr Agentic Access

x-agentic-access generated

Seekr exposes 212 API operations that an AI agent could call, of which 113 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: 99 read, 108 write, and 5 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.

artificial-intelligencegenerative-aiagentsllmfine-tuninginferenceragvector-databaseexplainabilityai-governancemodel-evaluationobservabilitygeospatial-intelligencedefensegovernmentregulated-industriesmcpagent-native
Operations: 212 Acting: 113 Human-in-the-loop: 0 Method: generated

By consequence

read 99 write 108 physical 5

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 /v1/flow/deployments physical conditional
PATCH /v1/flow/deployments/{deployment_id} physical conditional
PUT /v1/flow/deployments/{deployment_id}/demote physical conditional
PUT /v1/flow/deployments/{deployment_id}/promote physical conditional
POST /v1/flow/internal/deployments/{deployment_id}/status physical conditional

Source

Agentic Access

Raw ↑
generated: '2026-08-05'
method: generated
source: openapi/seekr-agents-openapi.json, openapi/seekr-explainability-openapi.json, openapi/seekr-llm-training-openapi.json,
  openapi/seekr-serving-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: 212
  by_action_class:
    connected: 99
    acting: 113
  by_consequence:
    read: 99
    write: 108
    physical: 5
  human_in_the_loop_required: 0
operations:
- path: /version
  method: get
  operationId: version_version_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/threads/{thread_id}/runs
  method: post
  operationId: run_agent_v1_threads__thread_id__runs_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: /v1/threads/{thread_id}/runs
  method: get
  operationId: list_runs_endpoint_v1_threads__thread_id__runs_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/threads/{thread_id}/runs/stream
  method: post
  operationId: run_agent_stream_v1_threads__thread_id__runs_stream_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: /v1/threads/{thread_id}/runs/stream/vercel
  method: post
  operationId: run_agent_stream_vercel_v1_threads__thread_id__runs_stream_vercel_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: /v1/threads/{thread_id}/runs/{run_id}/cancel
  method: post
  operationId: cancel_run_v1_threads__thread_id__runs__run_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: /v1/threads/{thread_id}/runs/{run_id}/attach
  method: get
  operationId: attach_to_run_v1_threads__thread_id__runs__run_id__attach_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/threads/{thread_id}/runs/{run_id}
  method: get
  operationId: get_run_endpoint_v1_threads__thread_id__runs__run_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/internal/runs/latest
  method: post
  operationId: list_agent_latest_runs_endpoint_v1_internal_runs_latest_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: /v1/internal/agents
  method: get
  operationId: list_registered_agents_endpoint_v1_internal_agents_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/health
  method: get
  operationId: health_check_v1_health_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/health/{agent_id}
  method: get
  operationId: agent_health_check_v1_health__agent_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/threads/{thread_id}/messages
  method: get
  operationId: list_messages_endpoint_v1_threads__thread_id__messages_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/threads/{thread_id}/messages
  method: post
  operationId: create_message_endpoint_v1_threads__thread_id__messages_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: /v1/threads
  method: post
  operationId: create_thread_endpoint_v1_threads_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: /v1/threads
  method: get
  operationId: list_threads_endpoint_v1_threads_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/threads/{thread_id}
  method: delete
  operationId: delete_thread_endpoint_v1_threads__thread_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: /v1/threads/{thread_id}
  method: get
  operationId: get_thread_endpoint_v1_threads__thread_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/threads/{thread_id}/messages/{message_id}
  method: patch
  operationId: update_message_endpoint_v1_threads__thread_id__messages__message_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: /v1/threads/{thread_id}/messages/{message_id}
  method: get
  operationId: get_message_endpoint_v1_threads__thread_id__messages__message_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/threads/{thread_id}/messages/{message_id}
  method: delete
  operationId: delete_message_endpoint_v1_threads__thread_id__messages__message_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: /v1/functions
  method: post
  operationId: upload_python_function_v1_functions_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: /v1/functions
  method: get
  operationId: list_python_function_endpoint_v1_functions_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/functions/{function_id}
  method: get
  operationId: get_python_function_endpoint_v1_functions__function_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/functions/{function_id}
  method: delete
  operationId: delete_python_function_endpoint_v1_functions__function_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: /v1/functions/{function_id}
  method: patch
  operationId: update_python_function_endpoint_v1_functions__function_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: /v1/internal/functions/validate-function-ids
  method: post
  operationId: validate_function_ids_v1_internal_functions_validate_function_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: /v1/internal/functions/by-ids
  method: post
  operationId: get_functions_by_ids_v1_internal_functions_by_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: /v1/observability/spans
  method: post
  operationId: query_spans_v1_observability_spans_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: /v1/observability/spans/{span_id}
  method: get
  operationId: retrieve_span_v1_observability_spans__span_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /version
  method: get
  operationId: version_version_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/explainability/
  method: get
  operationId: read_root_v1_explainability__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/explainability/status
  method: get
  operationId: check_status_v1_explainability_status_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/explainability/create-index
  method: post
  operationId: create_index_v1_explainability_create_index_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: /v1/explainability/populate-index
  method: post
  operationId: populate_index_v1_explainability_populate_index_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: /v1/explainability/delete-index
  method: post
  operationId: delete_index_v1_explainability_delete_index_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: /v1/explainability/influential-finetuning-data
  method: get
  operationId: get_influential_finetuning_data_v1_explainability_influential_finetuning_data_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/explainability/populate-index-job-status
  method: get
  operationId: populate_index_job_status_v1_explainability_populate_index_job_status_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/explainability/context-attributor
  method: post
  operationId: get_context_attribution_v1_explainability_context_attributor_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: /v1/explainability/context-attributor-from-run
  method: post
  operationId: get_context_attribution_from_run_v1_explainability_context_attributor_from_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: /v1/flow/agents/
  method: get
  operationId: list_agents_v1_flow_agents__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/agents/{agent_id}
  method: get
  operationId: get_agent_by_id_v1_flow_agents__agent_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/agents/{agent_id}
  method: patch
  operationId: patch_v1_flow_agents__agent_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: /v1/flow/agents/{agent_id}
  method: delete
  operationId: delete_v1_flow_agents__agent_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: /v1/flow/agents/create
  method: post
  operationId: create_v1_flow_agents_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: /v1/flow/agents/{agent_id}/update
  method: put
  operationId: update_v1_flow_agents__agent_id__update_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: /v1/flow/agents/{agent_id}/promote
  method: put
  operationId: promote_v1_flow_agents__agent_id__promote_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: /v1/flow/agents/{agent_id}/demote
  method: put
  operationId: demote_v1_flow_agents__agent_id__demote_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: /v1/flow/agents/{agent_id}/diff
  method: patch
  operationId: diff_v1_flow_agents__agent_id__diff_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: /v1/flow/internal/agents/{agent_id}/update-status
  method: patch
  operationId: update_status_v1_flow_internal_agents__agent_id__update_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: /v2/flow/agents/
  method: get
  operationId: list_agents_v2_flow_agents__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v2/flow/agents/{agent_id}
  method: get
  operationId: get_agent_by_id_v2_flow_agents__agent_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v2/flow/agents/{agent_id}
  method: patch
  operationId: patch_v2_flow_agents__agent_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: /v2/flow/agents/{agent_id}
  method: delete
  operationId: delete_v2_flow_agents__agent_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: /v2/flow/agents/create
  method: post
  operationId: create_v2_flow_agents_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: /v2/flow/agents/{agent_id}/update
  method: put
  operationId: update_v2_flow_agents__agent_id__update_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: /v2/flow/agents/{agent_id}/promote
  method: put
  operationId: promote_v2_flow_agents__agent_id__promote_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: /v2/flow/agents/{agent_id}/demote
  method: put
  operationId: demote_v2_flow_agents__agent_id__demote_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: /v2/flow/agents/{agent_id}/diff
  method: patch
  operationId: diff_v2_flow_agents__agent_id__diff_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: /v2/flow/internal/agents/{agent_id}/update-status
  method: patch
  operationId: update_status_v2_flow_internal_agents__agent_id__update_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: /v1/flow/alignment
  method: get
  operationId: alignment_list_v1_flow_alignment_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/alignment/ingestion
  method: get
  operationId: ingestion_list_v1_flow_alignment_ingestion_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/alignment/ingestion
  method: post
  operationId: ingest_files_v1_flow_alignment_ingestion_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: /v1/flow/alignment/ingestion/{ingestion_job_id}
  method: get
  operationId: ingestion_get_v1_flow_alignment_ingestion__ingestion_job_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/alignment/{alignment_job_id}
  method: get
  operationId: alignment_get_v1_flow_alignment__alignment_job_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/alignment/{alignment_job_id}
  method: delete
  operationId: alignment_delete_v1_flow_alignment__alignment_job_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: /v1/flow/alignment/generate
  method: post
  operationId: alignment_generate_v1_flow_alignment_generate_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: /v1/flow/alignment/{alignment_job_id}/cancel
  method: post
  operationId: cancel_alignment_job_v1_flow_alignment__alignment_job_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: /v1/flow/alignment/{alignment_job_id}/workflow-phase
  method: get
  operationId: alignment_workflow_phase_v1_flow_alignment__alignment_job_id__workflow_phase_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/alignment/{alignment_job_id}/outputs
  method: get
  operationId: alignment_outputs_v1_flow_alignment__alignment_job_id__outputs_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/ingestion
  method: get
  operationId: ingestion_list_v1_flow_ingestion_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/ingestion
  method: post
  operationId: ingest_files_v1_flow_ingestion_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: /v1/flow/ingestion/{ingestion_job_id}
  method: get
  operationId: ingestion_get_v1_flow_ingestion__ingestion_job_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/tools
  method: post
  operationId: create_tool_v1_flow_tools_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: /v1/flow/tools
  method: get
  operationId: list_tools_v1_flow_tools_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/tools/{tool_id}
  method: get
  operationId: get_tool_v1_flow_tools__tool_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/tools/{tool_id}
  method: patch
  operationId: patch_tool_v1_flow_tools__tool_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: /v1/flow/tools/{tool_id}
  method: put
  operationId: update_tool_v1_flow_tools__tool_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: /v1/flow/tools/{tool_id}
  method: delete
  operationId: delete_tool_v1_flow_tools__tool_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: /v1/flow/tools/{tool_id}/agents
  method: get
  operationId: get_agents_for_tool_v1_flow_tools__tool_id__agents_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/tools/{tool_id}/diff
  method: patch
  operationId: diff_tool_changes_v1_flow_tools__tool_id__diff_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: /v1/flow/tools/{tool_id}/duplicate
  method: post
  operationId: duplicate_tool_v1_flow_tools__tool_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: /v1/flow/internal/tools/mcp-connector/sync
  method: post
  operationId: sync_mcp_connector_tool_state_v1_flow_internal_tools_mcp_connector_sync_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: /v1/flow/internal/tools/tool-metadata/{tool_id}
  method: get
  operationId: get_tool_metadata_v1_flow_internal_tools_tool_metadata__tool_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow_internal/health
  method: get
  operationId: health_v1_flow_internal_health_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/data-jobs/gen_system_prompt
  method: post
  operationId: generate_system_prompt_v1_flow_data_jobs_gen_system_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: /v1/flow/data-jobs
  method: post
  operationId: submit_data_job_v1_flow_data_jobs_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: /v1/flow/data-jobs
  method: get
  operationId: get_data_jobs_v1_flow_data_jobs_get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/data-jobs/{data_job_id}
  method: get
  operationId: get_data_job_v1_flow_data_jobs__data_job_id__get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/flow/data-jobs/{data_job_id}
  method: patch
  operationId: patch_data_job_v1_flow_data_jobs__data_job_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: /v1/flow/data-jobs/{data_job_id}
  method: delete
  operationId: delete_data_job_v1_flow_data_jobs__data_job_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: /v1/flow/data-jobs/{data_job_id}/add-files
  method: post
  operationId: add_files_to_data_job_v1_flow_data_jobs__data_job_id__add_files_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: /v1/flow/data-jobs/{data_job_id}/remove-files
  method: post
  operationId: remove_files_from_data_job_v1_flow_data_jobs__data_job_id__remove_files_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: /v1/flow/data-jobs/{data_job_id}/start
  method: post
  operationId: start_data_job_alignment_v1_flow_data_jobs__data_job_id__start_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: /v1/flow/data-jobs/{data_job_id}/cancel
  method: post
  operationId: cancel_data_job_v1_flow_data_jobs__data_job_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: /v1/flow/data-jobs/{data_job_id}/clone
  method: post
  operationId: clone_data_job_v1_flow_data_jobs__data_job_id__clone_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


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