generated: '2026-09-23' method: generated source: openapi/perigon-ai-advanced-search-api-openapi.yml, openapi/perigon-contact-points-api-openapi.yml, openapi/perigon-monitors-api-openapi.yml, openapi/perigon-news-stories-api-openapi.yml, openapi/perigon-source-groups-api-openapi.yml, openapi/perigon-supplemental-endpoints-api-openapi.yml, openapi/perigon-utilities-api-openapi.yml, openapi/perigon-watchlists-api-openapi.yml, openapi/perigon-wikipedia-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: 45 by_action_class: connected: 27 acting: 18 by_consequence: read: 27 write: 18 human_in_the_loop_required: 0 operations: - path: /v1/summarize method: post operationId: search-summarizer x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/api/contactPoints method: get operationId: list-contact-points x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/api/contactPoints method: post operationId: create-contact-point 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: /v1/api/contactPoints/{uuid} method: get operationId: get-contact-point x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/api/contactPoints/{uuid} method: delete operationId: delete-contact-point 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: /v1/api/contactPoints/{uuid} method: patch operationId: update-contact-point 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: /v1/api/monitors method: get operationId: list-monitors-api x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/api/monitors method: post operationId: create-monitor-api 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: /v1/api/monitors/{uuid} method: get operationId: get-monitor-api x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/api/monitors/{uuid} method: delete operationId: archive-monitor-api 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: /v1/api/monitors/{uuid} method: patch operationId: update-monitor-api 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: /v1/api/monitors/{uuid}/activate method: post operationId: activate-monitor-api 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: /v1/api/monitors/{uuid}/events method: get operationId: list-monitor-events-api x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/api/monitors/{uuid}/newsletters method: get operationId: list-monitor-newsletters-api x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/api/monitors/{uuid}/pause method: post operationId: pause-monitor-api 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: /v1/api/monitors/{uuid}/summary method: get operationId: list-monitor-summaries-api x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/articles/all method: get operationId: search-articles x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/articles/refresh/jobs method: post operationId: submit-article-refresh-job 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: /v1/articles/refresh/jobs/{id} method: get operationId: get-article-refresh-job x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/articles/refresh/peek method: post operationId: peek-article-refresh 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: /v1/stories/all method: get operationId: search-stories x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/stories/history method: get operationId: get-story-history x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/stories/stats method: get operationId: get-story-counts x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/vector/news/all method: post operationId: vector-search-articles 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: /v1/api/sourceGroups method: get operationId: list-source-groups x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/api/sourceGroups method: post operationId: create-source-group 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: /v1/api/sourceGroups/resolve method: get operationId: resolve-source-groups x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/api/sourceGroups/{id} method: get operationId: get-source-group x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/api/sourceGroups/{id} method: delete operationId: delete-source-group 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: /v1/api/sourceGroups/{id} method: patch operationId: update-source-group 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: /v1/companies/all method: get operationId: search-companies x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/journalists/all method: get operationId: search-journalists x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/journalists/{id} method: get operationId: get-journalist-by-id x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/people/all method: get operationId: search-people x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/sources/all method: get operationId: search-sources x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/topics/all method: get operationId: search-topics x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/limits method: get operationId: get-limits x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/api/watchlists method: get operationId: list-watchlists x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/api/watchlists method: post operationId: create-watchlist 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: /v1/api/watchlists/resolve method: get operationId: resolve-watchlists x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/api/watchlists/{id} method: get operationId: get-watchlist x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /v1/api/watchlists/{id} method: delete operationId: delete-watchlist 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: /v1/api/watchlists/{id} method: patch operationId: update-watchlist 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: /v1/vector/wikipedia/all method: post operationId: vector-search-wikipedia 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: /v1/wikipedia/all method: get operationId: search-wikipedia x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none