H2O.ai · Agentic Access

H2O.ai Agentic Access

x-agentic-access generated

H2O.ai exposes 429 API operations that an AI agent could call, of which 259 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: 170 read, 239 write, 5 physical, and 15 safety-critical.

15 operations are classed safety-critical and should require human-in-the-loop approval at runtime.

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.

CompanyArtificial IntelligenceMachine-LearningMLOpsGenerative AILarge Language ModelsRetrieval Augmented GenerationData ScienceModel DeploymentAI AgentsEnterprise AI
Operations: 429 Acting: 259 Human-in-the-loop: 15 Method: generated

By consequence

read 170 write 239 physical 5 safety-critical 15

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
DELETE /admin/sessions/{session_id} safety-critical required
POST /ai_assistants/{assistant_id}/stop safety-critical required
DELETE /ai_assistants/{assistant_id}/tool safety-critical required
POST /collections/reset_all_collection_expirations safety-critical required
DELETE /collections/{collection_id}/prompt_settings safety-critical required
PUT /extractors/{extractor_id}/group_permissions safety-critical required
PUT /extractors/{extractor_id}/permissions safety-critical required
DELETE /groups/{group_id}/roles safety-critical required
POST /jobs/{job_id}/cancel safety-critical required
POST /messages/{question_id}/stop safety-critical required
PUT /prompt_templates/{prompt_template_id}/group_permissions safety-critical required
PUT /prompt_templates/{prompt_template_id}/permissions safety-critical required
POST /user_jobs/{job_id}/cancel safety-critical required
POST /users/{user_id}/configurations/{key_name}/reset safety-critical required
DELETE /users/{user_id}/roles safety-critical required
POST /ai_assistants/{assistant_id}/messages physical conditional
POST /ai_assistants/{assistant_id}/send_to_assistant physical conditional
POST /messages/{question_id}/hitl physical conditional
POST /models/{model_name}/answer_question physical conditional
POST /showcase/reorder physical conditional

Source

Agentic Access

Raw ↑ 
generated: '2026-08-04'
method: generated
source: openapi/h2o-ai-h2ogpte-openapi-original.yml, openapi/h2o-ai-mlops-scoring-openapi-original.yml
description: Recommended x-agentic-access execution contracts, classified heuristically from
  the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind
  audience per deployment. See research/curity/agentic-governance/.
summary:
  operations: 429
  by_action_class:
    acting: 259
    connected: 170
  by_consequence:
    write: 239
    read: 170
    safety-critical: 15
    physical: 5
  human_in_the_loop_required: 15
operations:
- path: /collections
  method: post
  operationId: create_collection
  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: /collections
  method: get
  operationId: list_collections
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/all
  method: get
  operationId: list_all_collections
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/count
  method: get
  operationId: get_collection_count
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}
  method: get
  operationId: get_collection
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}
  method: delete
  operationId: delete_collection
  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: /collections/{collection_id}
  method: patch
  operationId: update_collection
  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: /collections/{collection_id}/chunks/{chunk_ids}
  method: get
  operationId: get_collection_chunks
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/chunks/match
  method: post
  operationId: match_collection_chunks
  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: /collections/{collection_id}/chunks/search
  method: post
  operationId: search_collection_chunks
  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: /collections/delete_job
  method: post
  operationId: create_delete_collection_job
  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: /collections/reset_all_collection_expirations
  method: post
  operationId: reset_all_collection_expirations
  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: /collections/{collection_id}/topic_model
  method: post
  operationId: create_topic_model
  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: /collections/{collection_id}/topic_model
  method: delete
  operationId: delete_topic_model
  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: /collections/{collection_id}/prompt_template
  method: put
  operationId: update_collection_prompt_template
  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: /collections/{collection_id}/prompt_template
  method: delete
  operationId: delete_collection_prompt_template
  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: /collections/{collection_id}/expiry_date
  method: put
  operationId: update_collection_expiry_date
  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: /collections/{collection_id}/expiry_date
  method: delete
  operationId: delete_collection_expiry_date
  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: /collections/{collection_id}/inactivity_interval
  method: put
  operationId: update_collection_inactivity_interval
  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: /collections/{collection_id}/inactivity_interval
  method: delete
  operationId: delete_collection_inactivity_interval
  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: /collections/{collection_id}/workspace
  method: put
  operationId: update_collection_workspace
  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: /collections/{collection_id}/archive
  method: post
  operationId: archive_collection
  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: /collections/{collection_id}/unarchive
  method: post
  operationId: unarchive_collection
  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: /collections/{collection_id}/size_limit
  method: put
  operationId: set_collection_size_limit
  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: /collections/{collection_id}/size_limit
  method: delete
  operationId: remove_collection_size_limit
  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: /collections/{collection_id}/is_public
  method: post
  operationId: update_collection_privacy
  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: /collections/{collection_id}/settings
  method: get
  operationId: get_collection_settings
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/settings
  method: put
  operationId: update_collection_settings
  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: /collections/{collection_id}/prompt_settings
  method: delete
  operationId: reset_collection_prompt_settings
  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: /collections/{collection_id}/metadata
  method: get
  operationId: get_collection_metadata
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/metadata
  method: put
  operationId: update_collection_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: /collections/{collection_id}/thumbnail
  method: put
  operationId: update_collection_thumbnail
  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: /collections/{collection_id}/thumbnail
  method: delete
  operationId: delete_collection_thumbnail
  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: /collections/{collection_id}/thumbnail/job
  method: put
  operationId: create_update_collection_thumbnail_job
  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: /collections/{collection_id}/thumbnail/job
  method: delete
  operationId: create_delete_collection_thumbnail_job
  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: /collections/{collection_id}/chat_settings
  method: get
  operationId: get_collection_chat_settings
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/chat_settings
  method: put
  operationId: update_collection_chat_settings
  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: /collections/{collection_id}/documents
  method: get
  operationId: list_documents_for_collection
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/documents/{document_id}
  method: put
  operationId: insert_document_into_collection
  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: /collections/{collection_id}/documents/{document_id}
  method: delete
  operationId: delete_document_from_collection
  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: /collections/{collection_id}/documents/insert_job
  method: post
  operationId: create_insert_document_to_collection_job
  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: /collections/{collection_id}/documents/delete_job
  method: post
  operationId: create_delete_document_from_collection_job
  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: /collections/{collection_id}/documents/count
  method: get
  operationId: get_document_count_for_collection
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/chats
  method: get
  operationId: list_chat_sessions_for_collection
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/chats/count
  method: get
  operationId: get_chat_session_count_for_collection
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/questions
  method: get
  operationId: list_questions_for_collection
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/permissions
  method: get
  operationId: get_collection_permissions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/permissions
  method: delete
  operationId: unshare_collection_for_all
  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: /collections/{collection_id}/group_permissions
  method: get
  operationId: get_collection_group_permissions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/public_permissions
  method: get
  operationId: list_collection_public_permissions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/permissions/is_granted
  method: post
  operationId: is_collection_permission_granted
  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: /collections/{collection_id}/permissions/{username}
  method: put
  operationId: share_collection
  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: /collections/{collection_id}/permissions/{username}
  method: delete
  operationId: unshare_collection
  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: /collections/{collection_id}/group_permissions/{group_id}
  method: put
  operationId: share_collection_with_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: /collections/{collection_id}/group_permissions/{group_id}
  method: delete
  operationId: unshare_collection_from_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: /collections/{collection_id}/import_collection_job
  method: post
  operationId: create_import_collection_to_collection_job
  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: /collections/{collection_id}/scheduled_connectors
  method: get
  operationId: list_scheduled_connectors_for_collection
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/migrate_scheduled_connectors
  method: post
  operationId: migrate_scheduled_connectors_to_collection
  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: /collections/{collection_id}/migrate_chat_sessions_job
  method: post
  operationId: create_migrate_collection_chat_sessions_job
  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: /extractors/{extractor_id}/permissions
  method: get
  operationId: get_extractor_permissions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /extractors/{extractor_id}/permissions
  method: put
  operationId: reset_and_share_extractor
  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: /extractors/{extractor_id}/permissions
  method: delete
  operationId: unshare_extractor_for_all
  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: /extractors/{extractor_id}/group_permissions
  method: get
  operationId: get_extractor_group_permissions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /extractors/{extractor_id}/group_permissions
  method: put
  operationId: reset_and_share_extractor_with_groups
  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: /extractors/{extractor_id}/is_public
  method: post
  operationId: update_extractor_privacy
  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: /extractors/{extractor_id}/permissions/{username}
  method: put
  operationId: share_extractor
  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: /extractors/{extractor_id}/permissions/{username}
  method: delete
  operationId: unshare_extractor
  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: /extractors/{extractor_id}/group_permissions/{group_id}
  method: put
  operationId: share_extractor_with_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: /extractors/{extractor_id}/group_permissions/{group_id}
  method: delete
  operationId: unshare_extractor_from_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: /documents
  method: get
  operationId: list_documents
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /documents/count
  method: get
  operationId: get_document_count
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /documents/{document_id}
  method: get
  operationId: get_document
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /documents/{document_id}
  method: delete
  operationId: delete_document
  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: /documents/{document_id}
  method: patch
  operationId: update_document
  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: /documents/{document_id}/chunks
  method: get
  operationId: list_document_chunks
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /documents/process_job
  method: post
  operationId: create_process_document_job
  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: /documents/delete_job
  method: post
  operationId: create_delete_document_job
  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: /documents/{document_id}/collections
  method: get
  operationId: list_collections_for_document
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /documents/{document_id}/tags
  method: post
  operationId: create_tag_on_document
  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: /documents/{document_id}/tags/{tag_name}
  method: delete
  operationId: delete_tag_from_document
  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: /documents/{document_id}/chats
  method: get
  operationId: list_chat_sessions_for_document
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /documents/{document_id}/chats/count
  method: get
  operationId: get_chat_session_count_for_document
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /documents/{document_id}/summaries
  method: get
  operationId: list_document_summaries
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /documents/summaries/{summary_ids}
  method: delete
  operationId: delete_document_summaries
  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: /documents/{document_id}/metadata
  method: get
  operationId: get_document_metadata
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /documents/{document_id}/metadata
  method: put
  operationId: update_document_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: /documents/{document_id}/user_source_file
  method: get
  operationId: get_document_user_source_file
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /documents/{document_id}/page_ocr_model
  method: get
  operationId: get_document_page_ocr_model
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /documents/{document_id}/page_layout
  method: get
  operationId: get_document_page_layout
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /documents/{document_id}/internal_metadata
  method: get
  operationId: get_document_internal_metadata
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /documents/{document_id}/guardrails_settings
  method: get
  operationId: get_document_guardrails_settings
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /document_summaries/{summary_id}
  method: get
  operationId: get_document_summary
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /documents/{document_id}/users/{user_id}
  method: put
  operationId: add_user_document_permission
  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: /prompt_templates
  method: post
  operationId: create_prompt_template
  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: /prompt_templates
  method: get
  operationId: list_prompt_templates
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /prompt_templates/all
  method: get
  operationId: list_all_prompt_templates
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /prompt_templates/count
  method: get
  operationId: get_prompt_template_count
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /prompt_templates/default
  method: get
  operationId: get_default_prompt_template
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /prompt_templates/{prompt_template_id}
  method: get
  operationId: get_prompt_template
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /prompt_templates/{prompt_template_id}
  method: patch
  operationId: update_prompt_template
  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: /prompt_templates/{prompt_template_id}
  method: delete
  operationId: dele

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

Work with this as data

Every access contract here is available over the APIs.io API and to AI agents over MCP. Agentic Access is not yet its own endpoint on the v1 API. Reach it through catalog search and the tag graph, or the MCP server.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for agentic access

3 MCP tools reach this
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
Search the catalog 
curl "https://apis.io/api/v1/search?q=h2o-ai-agentic-access&limit=10"
Everything under a tag 
curl "https://apis.io/api/v1/tags/h2o-ai-agentic-access"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.