National Archives and Records Administration Agentic Access

generated: '2026-09-23'
method: generated
source: openapi/national-archives-and-records-administration-accounts-api-openapi.yml, openapi/national-archives-and-records-administration-announcements-api-openapi.yml,
  openapi/national-archives-and-records-administration-comments-api-openapi.yml, openapi/national-archives-and-records-administration-contributions-api-openapi.yml,
  openapi/national-archives-and-records-administration-extracted-text-api-openapi.yml, openapi/national-archives-and-records-administration-justifications-api-openapi.yml,
  openapi/national-archives-and-records-administration-metadata-api-openapi.yml, openapi/national-archives-and-records-administration-online-availability-api-openapi.yml,
  openapi/national-archives-and-records-administration-other-extracted-text-api-openapi.yml,
  openapi/national-archives-and-records-administration-partner-api-openapi.yml, openapi/national-archives-and-records-administration-records-api-openapi.yml,
  openapi/national-archives-and-records-administration-statistics-api-openapi.yml, openapi/national-archives-and-records-administration-tags-api-openapi.yml,
  openapi/national-archives-and-records-administration-transcriptions-api-openapi.yml, openapi/national-archives-and-records-administration-users-api-openapi.yml,
  openapi/national-archives-and-records-administration-utilities-api-openapi.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: 64
  by_action_class:
    connected: 44
    acting: 20
  by_consequence:
    read: 44
    write: 20
  human_in_the_loop_required: 0
operations:
- path: /users/userId/{userId}
  method: get
  operationId: getUsersUserIdByUserId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /users/userName/{userName}
  method: get
  operationId: getUsersUserNameByUserName
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /users
  method: get
  operationId: getUsers
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /users/lastViewedNotificationsAt/:userId
  method: put
  operationId: putUsersLastViewedNotificationsAt:userId
  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: /announcements/latest
  method: get
  operationId: getAnnouncementsLatest
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /announcements
  method: get
  operationId: getAnnouncements
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /announcements
  method: post
  operationId: postAnnouncements
  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: /announcements/{announcement_id}
  method: put
  operationId: putAnnouncementsByAnnouncementId
  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: /comments/search
  method: get
  operationId: getCommentsSearch
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /comments/{id}
  method: get
  operationId: getCommentsById
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /comments/naId/{naId}
  method: get
  operationId: getCommentsNaIdByNaId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /comments/userId/{userId}
  method: get
  operationId: getCommentsUserIdByUserId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /comments/
  method: post
  operationId: postComments
  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: /comments/{contributionId}
  method: patch
  operationId: patchCommentsByContributionId
  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: /comments/{contributionId}
  method: delete
  operationId: deleteCommentsByContributionId
  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: /contributions/
  method: put
  operationId: putContributions
  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: /contributions/
  method: get
  operationId: getContributions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contributions/search
  method: get
  operationId: getContributionsSearch
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contributions/targetObjectId/{targetObjectId}
  method: get
  operationId: getContributionsTargetObjectIdByTargetObjectId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contributions/parentContributionId/{parentContributionId}
  method: get
  operationId: getContributionsParentContributionIdByParentContributionId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contributions/contributionId/{contributionId}
  method: get
  operationId: getContributionsContributionIdByContributionId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contributions/userId/{userId}
  method: get
  operationId: getContributionsUserIdByUserId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contributions/targetNaId/{targetNaId}
  method: get
  operationId: getContributionsTargetNaIdByTargetNaId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /contributions/delete
  method: delete
  operationId: deleteContributionsDelete
  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: /extractedText/{naId}
  method: get
  operationId: getExtractedTextByNaId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /justifications
  method: get
  operationId: getJustifications
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /metadata/naid-availability/naid/{naId}
  method: get
  operationId: getMetadataNaidAvailabilityNaidByNaId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /online-availability
  method: get
  operationId: getOnlineAvailability
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /online-availability/naId/{naId}
  method: get
  operationId: getOnlineAvailabilityNaIdByNaId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /online-availability/update
  method: put
  operationId: putOnlineAvailabilityUpdate
  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: /online-availability/delete
  method: delete
  operationId: deleteOnlineAvailabilityDelete
  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: /other-extracted-text/search
  method: get
  operationId: getOtherExtractedTextSearch
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /partners/create
  method: post
  operationId: postPartnersCreate
  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: /partners/search
  method: get
  operationId: getPartnersSearch
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /partners/update
  method: patch
  operationId: patchPartnersUpdate
  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: /partners/contributions/partnerNameId/{partnerNameId}
  method: get
  operationId: getPartnersContributionsPartnerNameIdByPartnerNameId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /partners/contributions/fullName/{fullName}
  method: get
  operationId: getPartnersContributionsFullNameByFullName
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /records/search
  method: get
  operationId: getRecordsSearch
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /records/search/by-other-extracted-text
  method: get
  operationId: getRecordsSearchByOtherExtractedText
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /records/search/by-contribution
  method: get
  operationId: getRecordsSearchByContribution
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /records/search/by-tag
  method: get
  operationId: getRecordsSearchByTag
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /records/search/by-transcription
  method: get
  operationId: getRecordsSearchByTranscription
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /records/search/by-comment
  method: get
  operationId: getRecordsSearchByComment
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /records/parentNaId/{parentNaId}
  method: get
  operationId: getRecordsParentNaIdByParentNaId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /records/stats
  method: get
  operationId: getRecordsStats
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /tags/search
  method: get
  operationId: getTagsSearch
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /tags/{id}
  method: get
  operationId: getTagsById
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /tags/naId/{naId}
  method: get
  operationId: getTagsNaIdByNaId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /tags/userId/{userId}
  method: get
  operationId: getTagsUserIdByUserId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /tags/
  method: post
  operationId: postTags
  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: /tags/:contributionId
  method: delete
  operationId: deleteTags:contributionId
  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: /transcriptions/search
  method: get
  operationId: getTranscriptionsSearch
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /transcriptions/{id}
  method: get
  operationId: getTranscriptionsById
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /transcriptions/naId/{naId}
  method: get
  operationId: getTranscriptionsNaIdByNaId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /transcriptions/userId/{userId}
  method: get
  operationId: getTranscriptionsUserIdByUserId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /transcriptions/
  method: put
  operationId: putTranscriptions
  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: /transcriptions/
  method: post
  operationId: postTranscriptions
  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: /transcriptions/history/:parentContributionId
  method: post
  operationId: postTranscriptionsHistory:parentContributionId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /transcriptions/:contributionId/justificationId/:justificationId
  method: delete
  operationId: deleteTranscriptions:contributionIdJustificationId:justificationId
  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: /transcriptions/:contributionId/justificationId/:justificationId
  method: post
  operationId: postTranscriptions:contributionIdJustificationId:justificationId
  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: /users
  method: patch
  operationId: patchUsers
  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: /users/username
  method: patch
  operationId: patchUsersUsername
  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: /users/notifications/:userId
  method: get
  operationId: getUsersNotifications:userId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /fetch-coords
  method: post
  operationId: postFetchCoords
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none