generated: '2026-07-15' method: generated source: openapi/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: 68 by_action_class: connected: 40 acting: 28 by_consequence: read: 40 write: 28 human_in_the_loop_required: 0 operations: - path: /v1/verify_credentials method: get operationId: verifyCredentials x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/update_credentials method: patch operationId: updateCredentials x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/accounts/{id} method: get operationId: getAccount x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v1/accounts/{id}/statuses method: get operationId: getAccountStatuses x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v1/accounts/{id}/followers method: get operationId: getAccountFollowers x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v1/accounts/{id}/following method: get operationId: getAccountFollowing x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v1/accounts/{id}/follow method: post operationId: followAccount x-agentic-access: action-class: acting consequence: write subject: required scope: - follow audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/accounts/{id}/unfollow method: post operationId: unfollowAccount x-agentic-access: action-class: acting consequence: write subject: required scope: - follow audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/accounts/{id}/block method: post operationId: blockAccount x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/accounts/{id}/unblock method: post operationId: unblockAccount x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/accounts/{id}/mute method: post operationId: muteAccount x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/accounts/{id}/unmute method: post operationId: unmuteAccount x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/accounts/relationships method: get operationId: getRelationships x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/accounts/search method: get operationId: searchAccounts x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/accounts/lookup method: get operationId: lookupAccount x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v1/follow_requests method: get operationId: listFollowRequests x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/follow_requests/{id}/authorize method: post operationId: authorizeFollowRequest x-agentic-access: action-class: acting consequence: write subject: required scope: - follow audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/follow_requests/{id}/reject method: post operationId: rejectFollowRequest x-agentic-access: action-class: acting consequence: write subject: required scope: - follow audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/statuses method: post operationId: createStatus x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/statuses/{id} method: get operationId: getStatus x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v1/statuses/{id} method: delete operationId: deleteStatus x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/statuses/{id}/context method: get operationId: getStatusContext x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v1/statuses/{id}/favourited_by method: get operationId: getStatusFavouritedBy x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v1/statuses/{id}/reblogged_by method: get operationId: getStatusRebloggedBy x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v1/statuses/{id}/favourite method: post operationId: favouriteStatus x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/statuses/{id}/unfavourite method: post operationId: unfavouriteStatus x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/statuses/{id}/reblog method: post operationId: reblogStatus x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/statuses/{id}/unreblog method: post operationId: unreblogStatus x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/statuses/{id}/bookmark method: post operationId: bookmarkStatus x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/statuses/{id}/unbookmark method: post operationId: unbookmarkStatus x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/timelines/home method: get operationId: getHomeTimeline x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/timelines/public method: get operationId: getPublicTimeline x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v1/timelines/tag/{hashtag} method: get operationId: getHashtagTimeline x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v1/timelines/list/{list_id} method: get operationId: getListTimeline x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/media method: post operationId: uploadMedia x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/media/{id} method: get operationId: getMedia x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/media/{id} method: put operationId: updateMedia x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/media method: post operationId: uploadMediaV2 x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/notifications method: get operationId: listNotifications x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/notifications/{id} method: get operationId: getNotification x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/notifications/clear method: post operationId: clearNotifications x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/notifications/{id}/dismiss method: post operationId: dismissNotification x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v2/search method: get operationId: search x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/instance method: get operationId: getInstance x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v2/instance method: get operationId: getInstanceV2 x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /nodeinfo/2.0.json method: get operationId: getNodeInfo x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v1/trends method: get operationId: getTrends x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v1/suggestions method: get operationId: getSuggestions x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/directory method: get operationId: getDirectory x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none scope: - follow - push - read - write - path: /v1/lists method: get operationId: listLists x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/lists method: post operationId: createList x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/lists/{id} method: get operationId: getList x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/lists/{id} method: put operationId: updateList x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/lists/{id} method: delete operationId: deleteList x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/lists/{id}/accounts method: get operationId: getListAccounts x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/lists/{id}/accounts method: post operationId: addAccountsToList x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/lists/{id}/accounts method: delete operationId: removeAccountsFromList x-agentic-access: action-class: acting consequence: write subject: required scope: - write audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /v1/bookmarks method: get operationId: listBookmarks x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/favourites method: get operationId: listFavourites x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/blocks method: get operationId: listBlocks x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/mutes method: get operationId: listMutes x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1/domain_blocks method: get operationId: listDomainBlocks x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1.1/collections/create method: get operationId: createCollection x-agentic-access: action-class: connected consequence: read subject: optional scope: - write token: max-ttl: 3600 audit: none - path: /v1.1/collections/update method: get operationId: updateCollection x-agentic-access: action-class: connected consequence: read subject: optional scope: - write token: max-ttl: 3600 audit: none - path: /v1.1/collections/delete method: get operationId: deleteCollection x-agentic-access: action-class: connected consequence: read subject: optional scope: - write token: max-ttl: 3600 audit: none - path: /v1.1/direct method: get operationId: getDirectMessages x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1.1/stories method: get operationId: getStories x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /v1.1/push/update-subscription method: post operationId: updatePushSubscription x-agentic-access: action-class: acting consequence: write subject: required scope: - push audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required