generated: '2026-09-14'
method: generated
source: classification of every operation in openapi/*.yml, verified anonymously live on 2026-09-14
provider: APA Corporation
providerId: apa
description: 'Recommended x-agentic-access contract for the APA Corporation REST surface. The classification is uniform and that is the finding: all 28 operations on the public contract are safe HTTP GETs, none requires a credential, none changes state, and none has a consequence to escalate. An agent can call this entire surface unattended. The one caveat worth carrying into an agent policy is freshness, not risk: the share-price quote is edge-cached for 600 seconds, so an agent must not present it as a real-time price.'
summary:
  operations: 28
  write_operations: 0
  credentialed_operations: 0
  escalation_required: 0
  default_action_class: read
  default_consequence: none
policy:
  unattended_calls: allowed
  human_in_the_loop: not required
  rate_discipline: No published limit and no runtime signal (see rate-limits/apa-rate-limits.yml). An agent should honour the 600s Cache-Control rather than poll, cap per_page at the published 100, and read X-WP-TotalPages before paging.
  data_handling: Everything returned is already public on apacorp.com. The Authors API returns named individuals — five public author records — so an agent should treat those as published bylines, not as contact data, and should not enrich or cross-reference them.
operations:
- operationId: listAuthors
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-authors-api-openapi.yml
  path: /wp/v2/users
- operationId: getAuthor
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-authors-api-openapi.yml
  path: /wp/v2/users/{id}
- operationId: listContentTypes
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-discovery-api-openapi.yml
  path: /wp/v2/types
- operationId: listTaxonomies
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-discovery-api-openapi.yml
  path: /wp/v2/taxonomies
- operationId: listPostStatuses
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-discovery-api-openapi.yml
  path: /wp/v2/statuses
- operationId: getContentType
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-discovery-api-openapi.yml
  path: /wp/v2/types/{type}
- operationId: getTaxonomy
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-discovery-api-openapi.yml
  path: /wp/v2/taxonomies/{taxonomy}
- operationId: getPostStatus
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-discovery-api-openapi.yml
  path: /wp/v2/statuses/{status}
- operationId: listFeedItems
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-feed-items-api-openapi.yml
  path: /wp/v2/wprss_feed_item
- operationId: getFeedItem
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-feed-items-api-openapi.yml
  path: /wp/v2/wprss_feed_item/{id}
- operationId: listLeadership
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-leadership-api-openapi.yml
  path: /wp/v2/leaderships
- operationId: getLeadershipProfile
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-leadership-api-openapi.yml
  path: /wp/v2/leaderships/{id}
- operationId: listMediaHubVideos
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-media-hub-api-openapi.yml
  path: /wp/v2/presto-videos
- operationId: getMediaHubVideo
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-media-hub-api-openapi.yml
  path: /wp/v2/presto-videos/{id}
- operationId: listMediaAttachments
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-media-hub-api-openapi.yml
  path: /wp/v2/media
- operationId: getMediaAttachment
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-media-hub-api-openapi.yml
  path: /wp/v2/media/{id}
- operationId: listNewsroomPosts
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-newsroom-api-openapi.yml
  path: /wp/v2/posts
- operationId: getNewsroomPost
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-newsroom-api-openapi.yml
  path: /wp/v2/posts/{id}
- operationId: getOembedPayload
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-oembed-api-openapi.yml
  path: /oembed/1.0/embed
- operationId: listPages
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-pages-api-openapi.yml
  path: /wp/v2/pages
- operationId: getPage
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-pages-api-openapi.yml
  path: /wp/v2/pages/{id}
- operationId: searchContent
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-search-api-openapi.yml
  path: /wp/v2/search
- operationId: listCategories
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-taxonomy-api-openapi.yml
  path: /wp/v2/categories
- operationId: getCategory
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-taxonomy-api-openapi.yml
  path: /wp/v2/categories/{id}
- operationId: listTags
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-taxonomy-api-openapi.yml
  path: /wp/v2/tags
- operationId: getTag
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-taxonomy-api-openapi.yml
  path: /wp/v2/tags/{id}
- operationId: getApaShareQuote
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-ticker-api-openapi.yml
  path: /apa-ticker/v1/quote
- operationId: getTickerNamespaceIndex
  action_class: read
  consequence: none
  reversible: na
  auth_required: false
  escalation: none
  spec: openapi/apa-ticker-api-openapi.yml
  path: /apa-ticker/v1
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com