generated: '2026-07-15' method: generated source: openapi/beehiiv-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: 77 by_action_class: connected: 45 acting: 32 by_consequence: read: 45 write: 32 human_in_the_loop_required: 0 operations: - path: /publications/{publicationId}/advertisement_opportunities method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/authors method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/authors/{authorId} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/automations/{automationId}/journeys method: post operationId: create 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: /publications/{publicationId}/automations/{automationId}/journeys method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/automations/{automationId}/journeys/{automationJourneyId} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/automations method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/automations/{automationId} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/automations/{automationId}/emails method: get operationId: list-emails x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/bulk_subscriptions method: post operationId: create 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: /publications/{publicationId}/bulk_subscription_updates method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/bulk_subscription_updates/{id} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/subscriptions/bulk_actions method: put operationId: put 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: /publications/{publicationId}/subscriptions/bulk_actions method: patch operationId: patch 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: /publications/{publicationId}/subscriptions method: put operationId: put-status 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: /publications/{publicationId}/subscriptions method: patch operationId: patch-status 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: /publications/{publicationId}/subscriptions method: post operationId: create 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: /publications/{publicationId}/subscriptions method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/condition_sets method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/condition_sets/{conditionSetId} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/custom_fields method: post operationId: create 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: /publications/{publicationId}/custom_fields method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/custom_fields/{id} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/custom_fields/{id} method: put operationId: put 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: /publications/{publicationId}/custom_fields/{id} method: patch operationId: patch 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: /publications/{publicationId}/custom_fields/{id} method: delete operationId: delete 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: /publications/{publicationId}/data_privacy/deletion_requests method: post operationId: create 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: /publications/{publicationId}/data_privacy/deletion_requests method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/data_privacy/deletion_requests/{id} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/engagements method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/newsletter_lists method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/newsletter_lists/{newsletterListId} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/newsletter_lists/{newsletterListId}/subscriptions method: post operationId: create 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: /publications/{publicationId}/newsletter_lists/{newsletterListId}/subscriptions method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/newsletter_lists/{newsletterListId}/subscriptions/{newsletterListSubscriptionId} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/newsletter_lists/{newsletterListId}/subscriptions/{newsletterListSubscriptionId} method: patch operationId: update 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: /publications/{publicationId}/newsletter_lists/{newsletterListId}/subscriptions/by_subscription_id/{subscriptionId} method: patch operationId: update-by-subscription-id 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/identify method: get operationId: identify x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/polls method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/polls/{pollId} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/polls/{pollId}/responses method: get operationId: list-responses x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/posts method: post operationId: create 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: /publications/{publicationId}/posts method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/posts/{postId} method: patch operationId: update 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: /publications/{publicationId}/posts/{postId} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/posts/{postId} method: delete operationId: delete 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: /publications/{publicationId}/posts/aggregate_stats method: get operationId: aggregate-stats x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/post_templates method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/referral_program method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/segments method: post operationId: create 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: /publications/{publicationId}/segments method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/segments/{segmentId} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/segments/{segmentId} method: delete operationId: delete 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: /publications/{publicationId}/segments/{segmentId}/recalculate method: put operationId: recalculate 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: /publications/{publicationId}/segments/{segmentId}/members method: get operationId: list-members x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/segments/{segmentId}/results method: get operationId: expand-results x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/subscriptions/by_email/{email} method: get operationId: get-by-email x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/subscriptions/by_email/{email} method: put operationId: update-by-email 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: /publications/{publicationId}/subscriptions/{subscriptionId} method: get operationId: get-by-id x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/subscriptions/{subscriptionId} method: put operationId: put 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: /publications/{publicationId}/subscriptions/{subscriptionId} method: patch operationId: patch 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: /publications/{publicationId}/subscriptions/{subscriptionId} method: delete operationId: delete 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: /publications/{publicationId}/subscriptions/{subscriptionId}/tags method: post operationId: create 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: /publications/{publicationId}/tiers method: post operationId: create 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: /publications/{publicationId}/tiers method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/tiers/{tierId} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/tiers/{tierId} method: put operationId: put 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: /publications/{publicationId}/tiers/{tierId} method: patch operationId: patch 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: /publications/{publicationId}/webhooks method: post operationId: create 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: /publications/{publicationId}/webhooks method: get operationId: index x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/webhooks/{endpointId} method: get operationId: show x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /publications/{publicationId}/webhooks/{endpointId} method: patch operationId: update 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: /publications/{publicationId}/webhooks/{endpointId} method: delete operationId: delete 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: /workspaces/identify method: get operationId: identify x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /workspaces/publications/by_subscription_email/{email} method: get operationId: publications-by-subscription-email x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none