Hamad Bin Khalifa University · Agentic Access
Hamad Bin Khalifa University Agentic Access

x-agentic-access generated
Hamad Bin Khalifa University exposes 157 API operations that an AI agent could call, of which 81 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: 76 read, 79 write, and 2 safety-critical.
2 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.
EducationHigher EducationUniversityResearchOpen AccessRepositoryQatarMiddle East
Operations: 157 Acting: 81 Human-in-the-loop: 2 Method: generated
By consequence

read 76 write 79 safety-critical 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.
Method	Path	Consequence	Human-in-loop
DELETE	/account/articles/{article_id}/private_links/{link_id}	safety-critical	required
DELETE	/account/collections/{collection_id}/private_links/{link_id}	safety-critical	required
Source

Agentic Access

generated: '2026-07-15'
method: generated
source: openapi/hbku-figshare-api.yaml
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: 157
  by_action_class:
    connected: 76
    acting: 81
  by_consequence:
    read: 76
    write: 79
    safety-critical: 2
  human_in_the_loop_required: 2
operations:
- path: /altmetric/institutions
  method: get
  operationId: altmetric_institutions_list
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /articles
  method: get
  operationId: articles_list
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /articles/search
  method: post
  operationId: articles_search
  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: /articles/{article_id}
  method: get
  operationId: article_details
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /articles/{article_id}/versions
  method: get
  operationId: article_versions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /articles/{article_id}/versions/{version_id}
  method: get
  operationId: article_version_details
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /articles/{article_id}/versions/{version_id}/files
  method: get
  operationId: article_version_files
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /articles/{article_id}/download
  method: get
  operationId: public_article_download
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /articles/{article_id}/versions/{version_id}/download
  method: get
  operationId: public_article_version_download
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /articles/{article_id}/versions/{version_id}/embargo
  method: get
  operationId: article_version_embargo
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /articles/{article_id}/versions/{version_id}/confidentiality
  method: get
  operationId: article_version_confidentiality
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /articles/{article_id}/files
  method: get
  operationId: article_files
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /articles/{article_id}/files/{file_id}
  method: get
  operationId: article_file_details
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /account/articles/search
  method: post
  operationId: private_articles_search
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles
  method: get
  operationId: private_articles_list
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/articles
  method: post
  operationId: private_article_create
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}
  method: get
  operationId: private_article_details
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/articles/{article_id}
  method: put
  operationId: private_article_update
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}
  method: delete
  operationId: private_article_delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}
  method: patch
  operationId: private_article_partial_update
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/embargo
  method: get
  operationId: private_article_embargo_details
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/articles/{article_id}/embargo
  method: put
  operationId: private_article_embargo_update
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/embargo
  method: delete
  operationId: private_article_embargo_delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/resource
  method: post
  operationId: private_article_resource
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/publish
  method: post
  operationId: account_article_publish
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/unpublish
  method: post
  operationId: account_article_unpublish
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/reserve_doi
  method: post
  operationId: private_article_reserve_doi
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/reserve_handle
  method: post
  operationId: private_article_reserve_handle
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/download
  method: get
  operationId: private_article_download
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/articles/{article_id}/versions/{version_id}
  method: put
  operationId: article_version_update
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/versions/{version_id}
  method: patch
  operationId: article_version_partial_update
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/versions/{version_id}/update_thumb
  method: put
  operationId: article_version_update_thumb
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/authors
  method: get
  operationId: private_article_authors_list
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/articles/{article_id}/authors
  method: put
  operationId: private_article_authors_replace
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/authors
  method: post
  operationId: private_article_authors_add
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/authors/{author_id}
  method: delete
  operationId: private_article_author_delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/categories
  method: get
  operationId: private_article_categories_list
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/articles/{article_id}/categories
  method: put
  operationId: private_article_categories_replace
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/categories
  method: post
  operationId: private_article_categories_add
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/categories/{category_id}
  method: delete
  operationId: private_article_category_delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/confidentiality
  method: get
  operationId: private_article_confidentiality_details
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/articles/{article_id}/confidentiality
  method: put
  operationId: private_article_confidentiality_update
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/confidentiality
  method: delete
  operationId: private_article_confidentiality_delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/private_links
  method: get
  operationId: private_article_private_link
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/articles/{article_id}/private_links
  method: post
  operationId: private_article_private_link_create
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/private_links/{link_id}
  method: put
  operationId: private_article_private_link_update
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/private_links/{link_id}
  method: delete
  operationId: private_article_private_link_delete
  x-agentic-access:
    action-class: acting
    consequence: safety-critical
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 120
      exchange: true
      purpose-required: true
      proof-of-possession: true
    escalation:
      human-in-the-loop: required
    audit: required
- path: /account/articles/{article_id}/files
  method: get
  operationId: private_article_files_list
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/articles/{article_id}/files
  method: post
  operationId: private_article_upload_initiate
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/files/{file_id}
  method: get
  operationId: private_article_file
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/articles/{article_id}/files/{file_id}
  method: post
  operationId: private_article_upload_complete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/{article_id}/files/{file_id}
  method: delete
  operationId: private_article_file_delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/articles/export
  method: get
  operationId: account_article_report
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/articles/export
  method: post
  operationId: account_article_report_generate
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/authors/search
  method: post
  operationId: private_authors_search
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/authors/{author_id}
  method: get
  operationId: private_author_details
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /collections
  method: get
  operationId: collections_list
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/search
  method: post
  operationId: collections_search
  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: get
  operationId: collection_details
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/versions
  method: get
  operationId: collection_versions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/versions/{version_id}
  method: get
  operationId: collection_version_details
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /collections/{collection_id}/articles
  method: get
  operationId: collection_articles
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /account/collections
  method: get
  operationId: private_collections_list
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/collections
  method: post
  operationId: private_collection_create
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}
  method: get
  operationId: private_collection_details
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/collections/{collection_id}
  method: put
  operationId: private_collection_update
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}
  method: delete
  operationId: private_collection_delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}
  method: patch
  operationId: private_collection_patch
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/search
  method: post
  operationId: private_collections_search
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/reserve_doi
  method: post
  operationId: private_collection_reserve_doi
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/reserve_handle
  method: post
  operationId: private_collection_reserve_handle
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/resource
  method: post
  operationId: private_collection_resource
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/publish
  method: post
  operationId: private_collection_publish
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/authors
  method: get
  operationId: private_collection_authors_list
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/collections/{collection_id}/authors
  method: put
  operationId: private_collection_authors_replace
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/authors
  method: post
  operationId: private_collection_authors_add
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/authors/{author_id}
  method: delete
  operationId: private_collection_author_delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/categories
  method: get
  operationId: private_collection_categories_list
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/collections/{collection_id}/categories
  method: put
  operationId: private_collection_categories_replace
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/categories
  method: post
  operationId: private_collection_categories_add
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/categories/{category_id}
  method: delete
  operationId: private_collection_category_delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/articles
  method: get
  operationId: private_collection_articles_list
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/collections/{collection_id}/articles
  method: put
  operationId: private_collection_articles_replace
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/articles
  method: post
  operationId: private_collection_articles_add
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/articles/{article_id}
  method: delete
  operationId: private_collection_article_delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/private_links
  method: get
  operationId: private_collection_private_links_list
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/collections/{collection_id}/private_links
  method: post
  operationId: private_collection_private_link_create
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/private_links/{link_id}
  method: get
  operationId: private_collection_private_link_details
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/collections/{collection_id}/private_links/{link_id}
  method: put
  operationId: private_collection_private_link_update
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/collections/{collection_id}/private_links/{link_id}
  method: delete
  operationId: private_collection_private_link_delete
  x-agentic-access:
    action-class: acting
    consequence: safety-critical
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 120
      exchange: true
      purpose-required: true
      proof-of-possession: true
    escalation:
      human-in-the-loop: required
    audit: required
- path: /institutions/{institution_string_id}/articles/filter-by
  method: get
  operationId: institution_articles
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /account/institution
  method: get
  operationId: private_institution_details
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/institution/embargo_options
  method: get
  operationId: private_institution_embargo_options_details
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/institution/articles
  method: get
  operationId: private_institution_articles
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/institution/custom_fields
  method: get
  operationId: custom_fields_list
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - all
    token:
      max-ttl: 3600
    audit: none
- path: /account/institution/custom_fields/{custom_field_id}/items/upload
  method: post
  operationId: custom_fields_upload
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - all
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /account/categories
  method: get
  operationId: private_categories_

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