generated: '2026-07-15' method: generated source: openapi/discogs-openapi-original.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: 50 by_action_class: connected: 34 acting: 16 by_consequence: read: 34 write: 14 physical: 2 human_in_the_loop_required: 0 operations: - path: /artists/{artist_id} method: get operationId: getArtist x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /artists/{artist_id}/releases method: get operationId: getArtistReleases x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /database/search method: get operationId: searchDatabase x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /images/{filename} method: get operationId: getImage x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /inventory/export method: get operationId: listInventoryExports x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /inventory/export method: post operationId: requestInventoryExport 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: /inventory/export/{export_id} method: get operationId: getInventoryExport x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /inventory/export/{export_id}/download method: get operationId: downloadInventoryExport x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /inventory/upload method: get operationId: listInventoryUploads x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /inventory/upload/add method: post operationId: addInventoryUpload 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: /inventory/upload/change method: post operationId: changeInventoryUpload 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: /inventory/upload/delete method: post operationId: deleteInventoryUpload 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: /inventory/upload/{upload_id} method: get operationId: getInventoryUpload x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /labels/{label_id} method: get operationId: getLabel x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /labels/{label_id}/releases method: get operationId: getLabelReleases x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /lists/{list_id} method: get operationId: getList x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /marketplace/fee/{price} method: get operationId: getMarketplaceFee x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /marketplace/fee/{price}/{currency} method: get operationId: getMarketplaceFeeWithCurrency x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /marketplace/listings method: post operationId: createListing 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: /marketplace/listings/{listing_id} method: get operationId: getListing x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /marketplace/listings/{listing_id} method: post operationId: editListing 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: /marketplace/listings/{listing_id} method: delete operationId: deleteListing 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: /marketplace/orders method: get operationId: listOrders x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /marketplace/orders/{order_id} method: get operationId: getOrder x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /marketplace/orders/{order_id} method: post operationId: updateOrder x-agentic-access: action-class: acting consequence: physical subject: required scope: - write audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /marketplace/orders/{order_id}/messages method: get operationId: listOrderMessages x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /marketplace/orders/{order_id}/messages method: post operationId: addOrderMessage x-agentic-access: action-class: acting consequence: physical subject: required scope: - write audience: null token: max-ttl: 300 exchange: true purpose-required: true escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /marketplace/price_suggestions/{release_id} method: get operationId: getPriceSuggestions x-agentic-access: action-class: connected consequence: read subject: optional scope: - read token: max-ttl: 3600 audit: none - path: /masters/{master_id} method: get operationId: getMasterRelease x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /masters/{master_id}/versions method: get operationId: getMasterReleaseVersions x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /oauth/identity method: get operationId: getUserIdentity x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /releases/{release_id} method: get operationId: getRelease x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /releases/{release_id}/rating method: get operationId: getReleaseCommunityRating x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /releases/{release_id}/rating/{username} method: get operationId: getReleaseRatingByUser x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /releases/{release_id}/rating/{username} method: put operationId: updateReleaseRatingByUser 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: /releases/{release_id}/rating/{username} method: delete operationId: deleteReleaseRatingByUser 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: /releases/{release_id}/stats method: get operationId: getReleaseStats x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /users/{username} method: get operationId: getUserProfile x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /users/{username} method: post operationId: updateUserProfile 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: /users/{username}/collection/folders method: get operationId: getCollectionFolders x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /users/{username}/collection/folders method: post operationId: createCollectionFolder 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}/collection/folders/{folder_id}/releases method: get operationId: getCollectionItemsByFolder x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /users/{username}/collection/folders/{folder_id}/releases/{release_id} method: post operationId: addReleaseToCollectionFolder 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}/contributions method: get operationId: getUserContributions x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /users/{username}/inventory method: get operationId: getUserInventory x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /users/{username}/lists method: get operationId: getUserLists x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /users/{username}/submissions method: get operationId: getUserSubmissions x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /users/{username}/wants method: get operationId: getUserWantlist x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /users/{username}/wants/{release_id} method: put operationId: addReleaseToWantlist 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}/wants/{release_id} method: delete operationId: deleteReleaseFromWantlist 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