Suger · Agentic Access
Suger Agentic Access
x-agentic-access
generated
Suger exposes 106 API operations that an AI agent could call, of which 64 are state-changing ‘acting’ operations. This is a recommended x-agentic-access execution contract — the scope, audience, consequence tier, short-lived token constraints, and escalation each action should carry before it is handed to an autonomous agent.
By consequence: 42 read, 57 write, and 7 physical.
Contracts are classified heuristically from the provider’s OpenAPI and refresh on every APIs.io network build; audience is bound per deployment. The model follows Curity’s Access Intelligence (apidays Munich 2026). Browse every provider’s agent contracts at agentic-access.apis.io.
Cloud MarketplaceGTMSaaSBillingEntitlementRevenueCo-Sell
Operations: 106
Acting: 64
Human-in-the-loop: 0
Method: generated
By consequence
read 42
write 57
physical 7
Highest-consequence actions
The physical and safety-critical operations an agent could invoke — the ones that most warrant scoped tokens, tight TTLs, and escalation. Full per-operation contracts are in the source below.
| Method | Path | Consequence | Human-in-loop |
|---|---|---|---|
| POST | /org/{orgId}/buyer/{buyerId}/paymentTransaction/{paymentTransactionId}/refund | physical | conditional |
| PATCH | /org/{orgId}/invoice/{invoiceId}/info | physical | conditional |
| PATCH | /org/{orgId}/invoice/{invoiceId}/issue | physical | conditional |
| PATCH | /org/{orgId}/invoice/{invoiceId}/pay | physical | conditional |
| PATCH | /org/{orgId}/invoice/{invoiceId}/void | physical | conditional |
| POST | /org/{orgId}/offer/{offerId}/notifyContacts | physical | conditional |
| PATCH | /org/{orgId}/product/{productId}/fulfillmentUrl | physical | conditional |
Source
Agentic Access
generated: '2026-07-15'
method: generated
source: openapi/suger-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: 106
by_action_class:
connected: 42
acting: 64
by_consequence:
read: 42
write: 57
physical: 7
human_in_the_loop_required: 0
operations:
- path: /org/{orgId}/addon
method: get
operationId: ListAddons
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/addon
method: post
operationId: CreateAddon
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: /org/{orgId}/addon/{addonId}
method: delete
operationId: DeleteAddon
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: /org/{orgId}/addon/{addonId}
method: get
operationId: GetAddon
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/addon/{addonId}
method: patch
operationId: UpdateAddon
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: /org/{orgId}/apiClient
method: get
operationId: ListApiClients
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/apiClient/{apiClientId}
method: get
operationId: GetApiClient
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/batchCreateUsageRecordGroups
method: post
operationId: BatchReportUsageRecordGroups
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: /org/{orgId}/batchValidateUsageRecordGroups
method: post
operationId: BatchValidateUsageRecordGroups
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: /org/{orgId}/billableMetric
method: get
operationId: ListBillableMetrics
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/billableMetric
method: post
operationId: CreateBillableMetric
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: /org/{orgId}/billableMetric/{billableMetricId}
method: get
operationId: GetBillableMetric
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/billableMetric/{billableMetricId}
method: patch
operationId: UpdateBillableMetric
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: /org/{orgId}/buyer
method: get
operationId: ListBuyers
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/buyer
method: post
operationId: CreateBuyer
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: /org/{orgId}/buyer/{buyerId}
method: get
operationId: GetBuyer
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/buyer/{buyerId}
method: patch
operationId: UpdateBuyer
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: /org/{orgId}/buyer/{buyerId}/paymentTransaction/{paymentTransactionId}/refund
method: get
operationId: ListRefundOfPaymentTransaction
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/buyer/{buyerId}/paymentTransaction/{paymentTransactionId}/refund
method: post
operationId: CreateRefund
x-agentic-access:
action-class: acting
consequence: physical
subject: required
audience: null
token:
max-ttl: 300
exchange: true
purpose-required: true
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
- path: /org/{orgId}/buyer/{buyerId}/wallet
method: get
operationId: ListBuyerWallets
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/buyer/{buyerId}/wallet
method: post
operationId: CreateCreditWallet
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: /org/{orgId}/buyer/{buyerId}/wallet/{walletId}
method: delete
operationId: DeleteBuyerWallet
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: /org/{orgId}/buyer/{buyerId}/wallet/{walletId}
method: patch
operationId: UpdateCreditWallet
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: /org/{orgId}/buyer/{buyerId}/wallet/{walletId}/close
method: patch
operationId: CloseCreditWallet
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: /org/{orgId}/buyer/{buyerId}/wallet/{walletId}/default
method: patch
operationId: SetBuyerDefaultWallet
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: /org/{orgId}/contact
method: get
operationId: ListContactsByOrganization
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/contact
method: post
operationId: CreateContact
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: /org/{orgId}/contact/{contactId}
method: get
operationId: GetContact
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/contact/{contactId}
method: patch
operationId: UpdateContact
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: /org/{orgId}/contact/{contactId}/buyer/{buyerId}
method: delete
operationId: RemoveContactFromBuyer
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: /org/{orgId}/contact/{contactId}/buyer/{buyerId}
method: post
operationId: AddContactToBuyer
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: /org/{orgId}/contact/{contactId}/offer/{offerId}
method: delete
operationId: RemoveContactFromOffer
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: /org/{orgId}/contact/{contactId}/offer/{offerId}
method: post
operationId: AddContactToOffer
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: /org/{orgId}/contact/batch
method: post
operationId: BatchCreateContacts
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: /org/{orgId}/dailyRevenueRecord
method: get
operationId: ListDailyRevenueRecords
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/draftOffer
method: post
operationId: CreateOrUpdateDraftOffer
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: /org/{orgId}/draftProduct
method: post
operationId: CreateOrUpdateDraftProduct
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: /org/{orgId}/entitlement
method: get
operationId: ListEntitlements
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/entitlement
method: post
operationId: CreateEntitlement
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: /org/{orgId}/entitlement/{entitlementId}
method: get
operationId: GetEntitlement
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/entitlement/{entitlementId}/addCredit
method: post
operationId: AddEntitlementCredit
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: /org/{orgId}/entitlement/{entitlementId}/addon
method: post
operationId: ApplyAddonToEntitlement
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: /org/{orgId}/entitlement/{entitlementId}/approve
method: post
operationId: ApproveEntitlement
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: /org/{orgId}/entitlement/{entitlementId}/cancel
method: post
operationId: CancelEntitlement
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: /org/{orgId}/entitlement/{entitlementId}/divideCommit
method: post
operationId: DivideEntitlementCommit
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: /org/{orgId}/entitlement/{entitlementId}/entitlementName
method: patch
operationId: UpdateEntitlementName
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: /org/{orgId}/entitlement/{entitlementId}/entitlementTerm
method: get
operationId: ListEntitlementTerms
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/entitlement/{entitlementId}/entitlementTerm/{entitlementTermId}
method: delete
operationId: DeleteEntitlementTerm
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: /org/{orgId}/entitlement/{entitlementId}/entitlementTerm/{entitlementTermId}
method: get
operationId: GetEntitlementTerm
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/entitlement/{entitlementId}/metaInfo
method: patch
operationId: UpdateEntitlementMetaInfo
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: /org/{orgId}/entitlement/{entitlementId}/priceModel
method: patch
operationId: UpdateEntitlementPriceModel
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: /org/{orgId}/entitlement/{entitlementId}/scheduleCancellation
method: post
operationId: ScheduleEntitlementCancellation
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: /org/{orgId}/entitlement/{entitlementId}/seat
method: patch
operationId: UpdateEntitlementSeat
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: /org/{orgId}/entitlement/{entitlementId}/unscheduleCancellation
method: post
operationId: UnscheduleEntitlementCancellation
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: /org/{orgId}/entitlement/{entitlementId}/usageRecordGroup
method: post
operationId: ReportUsageRecordGroup
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: /org/{orgId}/invoice
method: get
operationId: ListInvoices
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/invoice/{invoiceId}
method: get
operationId: GetInvoice
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/invoice/{invoiceId}/info
method: patch
operationId: UpdateInvoiceInfo
x-agentic-access:
action-class: acting
consequence: physical
subject: required
audience: null
token:
max-ttl: 300
exchange: true
purpose-required: true
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
- path: /org/{orgId}/invoice/{invoiceId}/issue
method: patch
operationId: IssueInvoice
x-agentic-access:
action-class: acting
consequence: physical
subject: required
audience: null
token:
max-ttl: 300
exchange: true
purpose-required: true
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
- path: /org/{orgId}/invoice/{invoiceId}/pay
method: patch
operationId: PayInvoice
x-agentic-access:
action-class: acting
consequence: physical
subject: required
audience: null
token:
max-ttl: 300
exchange: true
purpose-required: true
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
- path: /org/{orgId}/invoice/{invoiceId}/preview
method: get
operationId: PreviewInvoiceEmail
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/invoice/{invoiceId}/void
method: patch
operationId: VoidInvoice
x-agentic-access:
action-class: acting
consequence: physical
subject: required
audience: null
token:
max-ttl: 300
exchange: true
purpose-required: true
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
- path: /org/{orgId}/notificationEvent
method: get
operationId: ListNotificationEvents
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/notificationEvent/{entityType}/{entityId}
method: get
operationId: ListNotificationEventsByEntity
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/notificationMessage
method: get
operationId: ListNotificationMessages
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/notificationMessage/{notificationMessageId}
method: get
operationId: GetNotificationMessage
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/offer
method: get
operationId: ListOffers
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/offer
method: post
operationId: CreateOffer
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: /org/{orgId}/offer/{offerId}
method: delete
operationId: DeleteOffer
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: /org/{orgId}/offer/{offerId}
method: get
operationId: GetOffer
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/offer/{offerId}/cancel
method: post
operationId: CancelOffer
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: /org/{orgId}/offer/{offerId}/eula
method: get
operationId: GetOfferEula
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/offer/{offerId}/extendExpiryDate
method: post
operationId: ExtendPrivateOfferExpiryDate
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: /org/{orgId}/offer/{offerId}/metaInfo
method: patch
operationId: UpdateOfferMetaInfo
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: /org/{orgId}/offer/{offerId}/notifyContacts
method: post
operationId: SendOfferNotifications
x-agentic-access:
action-class: acting
consequence: physical
subject: required
audience: null
token:
max-ttl: 300
exchange: true
purpose-required: true
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
- path: /org/{orgId}/offer/{offerId}/resellerEula
method: get
operationId: GetOfferResellerEula
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/offerExternalId/{offerExternalId}
method: get
operationId: GetOfferByExternalId
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/partner/{partner}/product
method: get
operationId: ListProductsByPartner
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/partner/{partner}/revenueRecord
method: get
operationId: ListRevenueRecords
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/partner/{partner}/revenueRecordDetail
method: get
operationId: ListRevenueRecordDetails
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/partner/{partner}/usageMeteringDailyRecord
method: get
operationId: ListUsageMeteringDailyRecords
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/paymentTransaction
method: get
operationId: ListPaymentTransactions
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/product
method: get
operationId: ListProducts
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/product
method: post
operationId: CreateProduct
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: /org/{orgId}/product/{productId}
method: delete
operationId: DeleteProduct
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: /org/{orgId}/product/{productId}
method: get
operationId: GetProduct
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/product/{productId}
method: patch
operationId: UpdateProduct
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: /org/{orgId}/product/{productId}/dimension
method: get
operationId: ListProductMeteringDimensions
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/product/{productId}/fulfillmentUrl
method: patch
operationId: UpdateProductFulfillmentUrl
x-agentic-access:
action-class: acting
consequence: physical
subject: required
audience: null
token:
max-ttl: 300
exchange: true
purpose-required: true
escalation:
human-in-the-loop: conditional
triggers:
- abnormal
- high-value
audit: required
- path: /org/{orgId}/product/{productId}/metaInfo
method: patch
operationId: UpdateProductMetaInfo
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: /org/{orgId}/product/{productId}/publish
method: patch
operationId: PublishProduct
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: /org/{orgId}/revenueReport
method: post
operationId: GetRevenueReport
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: /org/{orgId}/support/ticket
method: get
operationId: ListSupportTickets
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/support/ticket
method: post
operationId: CreateSupportTicket
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: /org/{orgId}/support/ticket/{ticketId}
method: get
operationId: GetSupportTicket
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/support/ticket/{ticketId}
method: patch
operationId: UpdateSupportTicket
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: /org/{orgId}/support/ticket/{ticketId}/attachment
method: post
operationId: CreateSupportTicketAttachment
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: /org/{orgId}/support/ticket/{ticketId}/close
method: patch
operationId: CloseSupportTicket
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: /org/{orgId}/support/ticket/{ticketId}/comment
method: post
operationId: CreateSupportTicketComment
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: /org/{orgId}/support/ticket/{ticketId}/reopen
method: patch
operationId: ReopenSupportTicket
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: /org/{orgId}/usageMeteringConfigInfo
method: get
operationId: GetUsageMeteringConfigInfo
x-agentic-access:
action-class: connected
consequence: read
subject: optional
token:
max-ttl: 3600
audit: none
- path: /org/{orgId}/usageMeteringConfigInfo
method: patch
operationId: UpdateUsageMeteringConfigInfo
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: /org/{orgId}/usag
# --- truncated at 32 KB (33 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/suger/refs/heads/main/agentic-access/suger-agentic-access.yml