University of Edinburgh · Agentic Access

University of Edinburgh Agentic Access

x-agentic-access derived

University of Edinburgh exposes 14 API operations that an AI agent could call, of which 0 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: 13 read.

1 operation 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.

UniversityHigher EducationEducationUnited KingdomScotlandRussell GroupResearch RepositoryOpen DataIdentity FederationResearch ComputingOAI-PMHArtificial Intelligence
Operations: 14 Acting: 0 Human-in-the-loop: 1 Method: derived

By consequence

read 13

Source

Agentic Access

Raw ↑ 
generated: '2026-08-19'
method: derived
source: openapi/university-of-edinburgh-datashare-repository-api-openapi.yml
operator: institution
description: >-
  Recommended x-agentic-access execution contracts for the institution-operated
  University of Edinburgh surfaces, derived from the probed OpenAPI documents in this
  repository. A governance starting point for exposing these APIs to AI agents — review
  and bind audience per deployment. Regenerated on 2026-08-19: the previous version was
  derived from the retired DSpace 6 legacy /rest API and classified twenty operations
  that no longer exist.
summary:
  operations: 14
  by_action_class:
    connected: 14
  by_consequence:
    read: 13
    generate: 1
  human_in_the_loop_required: 1
operations:

- api: Edinburgh DataShare REST API
  path: /
  method: get
  operationId: getRoot
  x-agentic-access:
    action-class: connected
    consequence: read
    audience: public
    note: Anonymous. Safe for unattended agent use.
- api: Edinburgh DataShare REST API
  path: /core/communities
  method: get
  operationId: listCommunities
  x-agentic-access:
    action-class: connected
    consequence: read
    audience: public
- api: Edinburgh DataShare REST API
  path: /core/collections
  method: get
  operationId: listCollections
  x-agentic-access:
    action-class: connected
    consequence: read
    audience: public
- api: Edinburgh DataShare REST API
  path: /discover/search/objects
  method: get
  operationId: searchObjects
  x-agentic-access:
    action-class: connected
    consequence: read
    audience: public
    note: Preferred anonymous route to item metadata, since /core/items requires auth.
- api: Edinburgh DataShare REST API
  path: /discover/browses
  method: get
  operationId: listBrowses
  x-agentic-access:
    action-class: connected
    consequence: read
    audience: public
- api: Edinburgh DataShare REST API
  path: /core/items
  method: get
  operationId: listItems
  x-agentic-access:
    action-class: connected
    consequence: read
    audience: authenticated
    note: Returns 401 anonymously on this deployment. Agents must hold a University credential.
- api: Edinburgh DataShare REST API
  path: /core/bitstreams
  method: get
  operationId: listBitstreams
  x-agentic-access:
    action-class: connected
    consequence: read
    audience: authenticated
    note: Returns 401 anonymously. Bitstreams are the binary research data — treat egress as sensitive.

- api: Edinburgh Research Archive (ERA) REST API
  path: /core/communities
  method: get
  operationId: listCommunities
  x-agentic-access:
    action-class: connected
    consequence: read
    audience: public
- api: Edinburgh Research Archive (ERA) REST API
  path: /discover/search/objects
  method: get
  operationId: searchObjects
  x-agentic-access:
    action-class: connected
    consequence: read
    audience: public

- api: Edinburgh DataShare OAI-PMH
  path: /request
  method: get
  operationId: oaiRequest
  x-agentic-access:
    action-class: connected
    consequence: read
    audience: public
    note: >-
      Fully anonymous bulk metadata harvesting. Agents must respect resumptionToken flow
      control and must not treat HTTP 200 as success — OAI returns protocol errors with 200.
- api: Edinburgh Research Archive (ERA) OAI-PMH
  path: /request
  method: get
  operationId: oaiRequest
  x-agentic-access:
    action-class: connected
    consequence: read
    audience: public

- api: EIDF Data Catalogue API
  path: /package_search
  method: get
  operationId: packageSearch
  x-agentic-access:
    action-class: connected
    consequence: read
    audience: public
- api: EIDF Data Catalogue API
  path: /package_show
  method: get
  operationId: packageShow
  x-agentic-access:
    action-class: connected
    consequence: read
    audience: public

- api: ELM — Edinburgh Language Models API
  path: /chat/completions
  method: post
  operationId: createChatCompletion
  x-agentic-access:
    action-class: connected
    consequence: generate
    audience: authenticated
    human-in-the-loop: required
    note: >-
      Generative inference against a University-operated LLM gateway, billed and governed
      under Edinburgh's own generative-AI guidance. Requires a bearer token, has no public
      self-service registration, and should not be driven unattended by an agent.