---
title: "Scopes"
description: "Every scope a token may hold, and the operations each one allows."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.sherpo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Scopes

A scope names one thing a token may do, as `resource:verb`: `product:read` reads products, `product:write` changes them, `product:delete` deletes them. A token holds either every scope its seller's seat holds (**Everything I can do**) or the ones chosen when it was created, and a call needs both the token and the seat to hold the operation's scope. Without it the call answers `403` with `WWW-Authenticate: Bearer error="insufficient_scope"`.

Most resources read as their names do. A few don't: `entry` covers every entry (lessons, posts and episodes) and their sections, pages are `custompage`, the store's site and settings are `site`, orders and refunds are `transaction`, a product's portfolio is `portfolio`, and the business itself is `organization`.

Each operation's page in the [reference](/merchant-api/reference) names its scope. This table lists every scope a public operation needs, with those operations; it is generated from the API on every build.

| Scope | Operations |
| --- | --- |
| `affiliate:read` | [`GET /affiliate_payouts`](/merchant-api/reference/list-affiliate-payouts), [`GET /commissions`](/merchant-api/reference/list-commissions), [`GET /commissions/stats`](/merchant-api/reference/commission-stats), [`GET /affiliates`](/merchant-api/reference/list-affiliates) |
| `affiliate:write` | [`POST /affiliate_payouts`](/merchant-api/reference/record-affiliate-payout), [`PUT /discounts/{discount}/affiliates`](/merchant-api/reference/set-affiliate), [`POST /discounts/{discount}/affiliates/remove`](/merchant-api/reference/remove-affiliate), [`POST /discounts/{discount}/affiliates/revert`](/merchant-api/reference/revert-affiliate) |
| `attendee:checkin` | [`POST /products/{product}/attendees/check_in`](/merchant-api/reference/check-in-event-attendee), [`DELETE /products/{product}/attendees/{attendee}/check_in`](/merchant-api/reference/undo-event-attendee-check-in), [`GET /products/{product}/attendees/check_in/stats`](/merchant-api/reference/event-check-in-stats), [`GET /products/check_in`](/merchant-api/reference/list-check-in-events) |
| `automation:read` | [`GET /automations`](/merchant-api/reference/list-all-automations), [`GET /automation_runs`](/merchant-api/reference/list-automation-runs), [`GET /automations/{automation}`](/merchant-api/reference/get-automation) |
| `automation:write` | [`POST /automations`](/merchant-api/reference/create-automation), [`PATCH /automations/{automation}`](/merchant-api/reference/update-automation), [`POST /automations/{automation}/pause`](/merchant-api/reference/pause-automation), [`POST /automations/{automation}/resume`](/merchant-api/reference/resume-automation) |
| `automation:delete` | [`DELETE /automations/{automation}`](/merchant-api/reference/delete-automation) |
| `certificate:read` | [`GET /products/{product}/certificates`](/merchant-api/reference/list-certificates), [`GET /certificates/issues`](/merchant-api/reference/list-certificate-issues), [`GET /products/{product}/certificates/issues`](/merchant-api/reference/list-product-certificate-issues), [`GET /products/{product}/certificates/stats`](/merchant-api/reference/certificate-stats) |
| `certificate:write` | [`POST /products/{product}/certificates`](/merchant-api/reference/create-certificate), [`POST /products/{product}/certificates/{certificate}/issue`](/merchant-api/reference/issue-certificate), [`PATCH /products/{product}/certificates/{certificate}`](/merchant-api/reference/update-certificate), [`POST /products/{product}/certificates/issues/{issue}/revoke`](/merchant-api/reference/revoke-certificate-issue) |
| `certificate:delete` | [`DELETE /products/{product}/certificates/{certificate}`](/merchant-api/reference/delete-certificate) |
| `custompage:read` | [`GET /pages`](/merchant-api/reference/list-pages), [`GET /pages/{page}`](/merchant-api/reference/get-page) |
| `custompage:write` | [`POST /pages`](/merchant-api/reference/create-page), [`PATCH /pages/{page}`](/merchant-api/reference/update-page), [`POST /pages/{page}/publish`](/merchant-api/reference/publish-page), [`POST /pages/{page}/unpublish`](/merchant-api/reference/unpublish-page) |
| `custompage:delete` | [`DELETE /pages/{page}`](/merchant-api/reference/delete-page) |
| `customer:read` | [`GET /customers/stats`](/merchant-api/reference/customer-stats), [`GET /grants`](/merchant-api/reference/list-grants), [`GET /feeds`](/merchant-api/reference/list-feeds), [`GET /products/{product}/feeds`](/merchant-api/reference/list-product-feeds), [`GET /products/{product}/licenses`](/merchant-api/reference/list-licenses), [`GET /products/{product}/licenses/{license}`](/merchant-api/reference/get-license), [`GET /products/{product}/licenses/stats`](/merchant-api/reference/license-stats), [`GET /products/{product}/licenses/{license}/activations`](/merchant-api/reference/list-license-activations), [`POST /products/{product}/licenses/verify`](/merchant-api/reference/verify-license), [`POST /products/{product}/licenses/token`](/merchant-api/reference/refresh-license-token), [`GET /license_signing_keys`](/merchant-api/reference/list-license-signing-keys), [`GET /entitlements`](/merchant-api/reference/list-entitlements), [`GET /customers`](/merchant-api/reference/list-customers), [`GET /customer_activity`](/merchant-api/reference/list-customer-activity), [`GET /products/{product}/customers`](/merchant-api/reference/list-product-customers), [`GET /products/{product}/customers/stats`](/merchant-api/reference/product-customer-stats), [`GET /checkouts`](/merchant-api/reference/list-checkouts), [`GET /customers/{customer}`](/merchant-api/reference/get-customer), [`GET /products/{product}/attendees`](/merchant-api/reference/list-event-attendees), [`GET /products/{product}/attendees/stats`](/merchant-api/reference/event-attendee-stats), [`GET /customers/{customer}/answers`](/merchant-api/reference/list-customer-answers), [`GET /products/{product}/requests`](/merchant-api/reference/list-product-requests) |
| `customer:write` | [`POST /grants`](/merchant-api/reference/grant-access), [`POST /grants/{grant}/revoke`](/merchant-api/reference/revoke-grant), [`PATCH /products/{product}/feeds/{feed}`](/merchant-api/reference/update-feed), [`POST /products/{product}/feeds/{feed}/revoke`](/merchant-api/reference/revoke-feed), [`POST /products/{product}/feeds/unblock`](/merchant-api/reference/unblock-feed), [`POST /products/{product}/licenses`](/merchant-api/reference/record-license), [`PATCH /products/{product}/licenses/{license}`](/merchant-api/reference/update-license), [`POST /products/{product}/licenses/{license}/disable`](/merchant-api/reference/disable-license), [`POST /products/{product}/licenses/{license}/enable`](/merchant-api/reference/enable-license), [`POST /products/{product}/licenses/{license}/activations/{activation}/deactivate`](/merchant-api/reference/deactivate-license-activation), [`POST /products/{product}/licenses/{license}/rotate`](/merchant-api/reference/rotate-license), [`POST /products/{product}/licenses/activate`](/merchant-api/reference/activate-license), [`POST /products/{product}/licenses/deactivate`](/merchant-api/reference/deactivate-license), [`POST /license_signing_keys/rotate`](/merchant-api/reference/rotate-license-signing-keys), [`PUT /products/{product}/customers/{customer}/answers`](/merchant-api/reference/set-customer-answers), [`POST /products/{product}/requests/{request}/approve`](/merchant-api/reference/approve-product-request), [`POST /products/{product}/requests/{request}/decline`](/merchant-api/reference/decline-product-request), [`POST /products/{product}/requests/{request}/promote`](/merchant-api/reference/promote-product-request) |
| `customer:delete` | [`POST /customers/{customer}/erase`](/merchant-api/reference/erase-customer) |
| `discount:read` | [`GET /discounts`](/merchant-api/reference/list-discounts), [`GET /discounts/{discount}`](/merchant-api/reference/get-discount), [`GET /discounts/stats`](/merchant-api/reference/discount-stats) |
| `discount:write` | [`POST /discounts`](/merchant-api/reference/create-discount), [`PATCH /discounts/{discount}`](/merchant-api/reference/update-discount), [`POST /discounts/{discount}/archive`](/merchant-api/reference/archive-discount), [`POST /discounts/{discount}/restore`](/merchant-api/reference/restore-discount), [`POST /discounts/{discount}/restrict`](/merchant-api/reference/restrict-discount), [`POST /discounts/{discount}/attach`](/merchant-api/reference/attach-discount), [`POST /discounts/{discount}/detach`](/merchant-api/reference/detach-discount) |
| `discount:delete` | [`DELETE /discounts/{discount}`](/merchant-api/reference/delete-discount) |
| `entry:read` | [`GET /products/{product}/entries`](/merchant-api/reference/list-entries), [`GET /products/{product}/entries/details`](/merchant-api/reference/list-entry-details), [`GET /products/{product}/entries/{entry}`](/merchant-api/reference/get-entry), [`GET /products/{product}/entries/stats`](/merchant-api/reference/entry-stats), [`GET /products/{product}/entries/sections`](/merchant-api/reference/list-entry-sections), [`GET /products/{product}/entries/tags`](/merchant-api/reference/list-entry-tags), [`GET /products/{product}/sections`](/merchant-api/reference/list-sections) |
| `entry:write` | [`POST /products/{product}/entries`](/merchant-api/reference/create-entry), [`PATCH /products/{product}/entries/{entry}`](/merchant-api/reference/update-entry), [`POST /products/{product}/entries/{entry}/publish`](/merchant-api/reference/publish-entry), [`POST /products/{product}/entries/{entry}/unpublish`](/merchant-api/reference/unpublish-entry), [`POST /products/{product}/entries/reorder`](/merchant-api/reference/reorder-entries), [`POST /products/{product}/sections`](/merchant-api/reference/create-section), [`POST /products/{product}/sections/rename`](/merchant-api/reference/rename-section), [`POST /products/{product}/sections/remove`](/merchant-api/reference/remove-section) |
| `entry:delete` | [`DELETE /products/{product}/entries/{entry}`](/merchant-api/reference/delete-entry) |
| `file:read` | [`GET /{kind}/{id}/attachments`](/merchant-api/reference/list-attachments), [`GET /body_schema`](/merchant-api/reference/get-body-schema), [`GET /{kind}/{id}/body`](/merchant-api/reference/read-body), [`GET /products/{product}/prompts`](/merchant-api/reference/list-prompts), [`GET /products/{product}/prompts/{prompt}`](/merchant-api/reference/get-prompt), [`GET /assets`](/merchant-api/reference/list-assets), [`GET /assets/{asset}`](/merchant-api/reference/get-asset), [`GET /quota`](/merchant-api/reference/get-quota), [`GET /assets/{asset}/outputs`](/merchant-api/reference/list-media-outputs), [`GET /assets/{asset}/output`](/merchant-api/reference/get-media-output), [`POST /assets/{asset}/url`](/merchant-api/reference/get-asset-url), [`GET /products/{product}/file_stats`](/merchant-api/reference/product-file-stats), [`GET /asset_deliveries`](/merchant-api/reference/list-asset-deliveries), [`GET /asset_uses`](/merchant-api/reference/list-asset-uses), [`GET /files/{capability}`](/merchant-api/reference/get-file) |
| `file:write` | [`POST /{kind}/{id}/attachments`](/merchant-api/reference/attach-asset), [`PUT /{kind}/{id}/body`](/merchant-api/reference/set-body), [`POST /{kind}/{id}/body/edit`](/merchant-api/reference/edit-body), [`POST /{kind}/{id}/body/publish`](/merchant-api/reference/publish-body), [`POST /{kind}/{id}/body/discard`](/merchant-api/reference/discard-staged), [`PATCH /attachments/{attachment}`](/merchant-api/reference/update-attachment), [`POST /{kind}/{id}/attachments/reorder`](/merchant-api/reference/reorder-attachments), [`POST /attachments/{attachment}/detach`](/merchant-api/reference/detach-attachment), [`POST /products/{product}/prompts`](/merchant-api/reference/create-prompt), [`PATCH /products/{product}/prompts/{prompt}`](/merchant-api/reference/update-prompt), [`PUT /products/{product}/poster`](/merchant-api/reference/set-product-poster), [`POST /assets`](/merchant-api/reference/create-asset), [`PATCH /assets/{asset}`](/merchant-api/reference/update-asset), [`PATCH /assets/{asset}/output`](/merchant-api/reference/update-media-output), [`POST /assets/{asset}/outputs/generate`](/merchant-api/reference/generate-media-output), [`POST /assets/{asset}/outputs/publish`](/merchant-api/reference/publish-media-output), [`POST /uploads`](/merchant-api/reference/create-upload), [`POST /uploads/inline`](/merchant-api/reference/create-inline-upload), [`POST /assets/{asset}/complete`](/merchant-api/reference/complete-upload), [`POST /assets/{asset}/cancel`](/merchant-api/reference/cancel-upload), [`POST /assets/{asset}/move`](/merchant-api/reference/move-asset), [`POST /assets/{asset}/replace`](/merchant-api/reference/replace-asset) |
| `file:delete` | [`DELETE /products/{product}/prompts/{prompt}`](/merchant-api/reference/delete-prompt), [`DELETE /assets/{asset}`](/merchant-api/reference/delete-asset), [`DELETE /assets/{asset}/output`](/merchant-api/reference/delete-media-output) |
| `integration:read` | [`GET /integrations`](/merchant-api/reference/list-integrations) |
| `integration:write` | [`PUT /integrations/{integration}`](/merchant-api/reference/set-integration) |
| `organization:read` | [`GET /organization`](/merchant-api/reference/get-organization), [`GET /balance`](/merchant-api/reference/get-balance), [`GET /payouts`](/merchant-api/reference/list-payouts), [`POST /plan_store/preview/query`](/merchant-api/reference/preview-plan-store), [`GET /organization/plan/change/preview`](/merchant-api/reference/preview-plan-change), [`GET /notifications`](/merchant-api/reference/list-notifications), [`GET /webhooks`](/merchant-api/reference/list-webhooks), [`GET /webhooks/{webhook}`](/merchant-api/reference/get-webhook), [`GET /webhook_deliveries`](/merchant-api/reference/list-webhook-deliveries), [`GET /v1/merchants`](/merchant-api/reference/list-merchants), [`GET /v1/merchants/{merchant}`](/merchant-api/reference/get-merchant) |
| `organization:write` | [`PATCH /organization`](/merchant-api/reference/update-organization), [`PUT /organization/logo`](/merchant-api/reference/set-organization-logo), [`POST /organization/plan/change`](/merchant-api/reference/change-plan), [`DELETE /organization/plan/change`](/merchant-api/reference/cancel-plan-change), [`POST /organization/plan/change/confirm`](/merchant-api/reference/confirm-plan-change), [`PUT /organization/auto_upgrade`](/merchant-api/reference/set-auto-upgrade), [`PUT /organization/auto_add_ons`](/merchant-api/reference/set-auto-add-ons), [`POST /notifications`](/merchant-api/reference/create-notification), [`PATCH /notifications/{notification}`](/merchant-api/reference/update-notification), [`POST /webhooks`](/merchant-api/reference/create-webhook), [`PATCH /webhooks/{webhook}`](/merchant-api/reference/update-webhook), [`POST /webhooks/{webhook}/secret/roll`](/merchant-api/reference/roll-webhook-secret), [`POST /webhook_deliveries/{delivery}/resend`](/merchant-api/reference/resend-webhook-delivery) |
| `organization:delete` | [`DELETE /notifications/{notification}`](/merchant-api/reference/delete-notification), [`DELETE /webhooks/{webhook}`](/merchant-api/reference/delete-webhook) |
| `portfolio:read` | [`GET /products/{product}/portfolio`](/merchant-api/reference/get-portfolio), [`GET /products/{product}/portfolio/valuation`](/merchant-api/reference/get-portfolio-valuation), [`GET /products/{product}/portfolio/holdings`](/merchant-api/reference/list-holdings), [`GET /products/{product}/portfolio/holdings/{holding}/announced_files`](/merchant-api/reference/list-announced-files), [`GET /products/{product}/portfolio/events`](/merchant-api/reference/list-portfolio-events), [`GET /products/{product}/portfolio/snapshots`](/merchant-api/reference/list-portfolio-snapshots), [`GET /symbols`](/merchant-api/reference/search-symbols), [`POST /symbols/quotes/query`](/merchant-api/reference/quote-symbols) |
| `portfolio:write` | [`PATCH /products/{product}/portfolio`](/merchant-api/reference/update-portfolio), [`PATCH /products/{product}/portfolio/holdings/{holding}`](/merchant-api/reference/update-holding), [`POST /products/{product}/portfolio/events`](/merchant-api/reference/record-portfolio-event) |
| `price:read` | [`GET /prices`](/merchant-api/reference/list-prices), [`GET /products/{product}/prices`](/merchant-api/reference/list-product-prices), [`GET /products/{product}/checkout/simulate`](/merchant-api/reference/simulate-checkout) |
| `price:write` | [`POST /products/{product}/prices`](/merchant-api/reference/create-price), [`PATCH /products/{product}/prices/{price}`](/merchant-api/reference/update-price), [`POST /products/{product}/prices/{price}/highlight`](/merchant-api/reference/highlight-price), [`POST /products/{product}/prices/{price}/archive`](/merchant-api/reference/archive-price), [`POST /products/{product}/prices/{price}/restore`](/merchant-api/reference/restore-price) |
| `price:delete` | [`DELETE /products/{product}/prices/{price}`](/merchant-api/reference/delete-price) |
| `product:read` | [`GET /categories`](/merchant-api/reference/list-categories), [`GET /products`](/merchant-api/reference/list-products), [`GET /products/{product}`](/merchant-api/reference/get-product), [`GET /products/summaries`](/merchant-api/reference/product-summaries), [`GET /tiers`](/merchant-api/reference/list-tiers), [`GET /products/{product}/tiers`](/merchant-api/reference/list-product-tiers), [`GET /{kind}/{id}/access_requirements`](/merchant-api/reference/list-access-requirements), [`POST /access_requirements/query`](/merchant-api/reference/list-resource-access), [`GET /products/{product}/stats`](/merchant-api/reference/product-stats), [`GET /products/stats`](/merchant-api/reference/catalog-stats), [`GET /products/{product}/traffic/stats`](/merchant-api/reference/product-traffic-stats), [`GET /products/{product}/questions`](/merchant-api/reference/list-product-questions), [`GET /products/{product}/sessions`](/merchant-api/reference/list-event-sessions), [`GET /products/{product}/cancellation`](/merchant-api/reference/get-event-cancellation), [`GET /products/{product}/activity`](/merchant-api/reference/list-software-events) |
| `product:write` | [`POST /products`](/merchant-api/reference/create-product), [`PATCH /products/{product}`](/merchant-api/reference/update-product), [`POST /products/{product}/publish`](/merchant-api/reference/publish-product), [`POST /products/{product}/unpublish`](/merchant-api/reference/unpublish-product), [`POST /products/{product}/discontinue`](/merchant-api/reference/discontinue-product), [`POST /products/{product}/reinstate`](/merchant-api/reference/reinstate-product), [`POST /products/{product}/unlist`](/merchant-api/reference/unlist-product), [`POST /products/{product}/relist`](/merchant-api/reference/relist-product), [`POST /products/{product}/tiers`](/merchant-api/reference/create-tier), [`PATCH /products/{product}/tiers/{tier}`](/merchant-api/reference/update-tier), [`POST /products/{product}/tiers/reorder`](/merchant-api/reference/reorder-tiers), [`PUT /{kind}/{id}/access_requirements`](/merchant-api/reference/set-access-requirement), [`DELETE /{kind}/{id}/access_requirements`](/merchant-api/reference/clear-access-requirement), [`POST /products/{product}/questions`](/merchant-api/reference/create-product-question), [`PATCH /products/{product}/questions/{question}`](/merchant-api/reference/update-product-question), [`POST /products/{product}/sessions`](/merchant-api/reference/create-event-session), [`PATCH /products/{product}/sessions/{session}`](/merchant-api/reference/update-event-session), [`POST /products/{product}/activity`](/merchant-api/reference/record-software-event), [`PATCH /products/{product}/activity/{event}`](/merchant-api/reference/update-software-event) |
| `product:delete` | [`DELETE /products/{product}`](/merchant-api/reference/delete-product), [`DELETE /products/{product}/tiers/{tier}`](/merchant-api/reference/delete-tier), [`DELETE /products/{product}/questions/{question}`](/merchant-api/reference/delete-product-question), [`DELETE /products/{product}/sessions/{session}`](/merchant-api/reference/delete-event-session), [`DELETE /products/{product}/activity/{event}`](/merchant-api/reference/delete-software-event) |
| `quiz:read` | [`GET /attempts`](/merchant-api/reference/list-attempts), [`GET /products/{product}/attempts`](/merchant-api/reference/list-product-attempts), [`GET /products/{product}/attempts/{attempt}`](/merchant-api/reference/get-attempt), [`GET /products/{product}/entries/{entry}/quizzes`](/merchant-api/reference/list-quizzes), [`GET /products/{product}/entries/{entry}/quizzes/{quiz}`](/merchant-api/reference/get-quiz), [`GET /products/{product}/quizzes/stats`](/merchant-api/reference/quiz-stats) |
| `quiz:write` | [`POST /products/{product}/entries/{entry}/quizzes`](/merchant-api/reference/create-quiz), [`PATCH /products/{product}/entries/{entry}/quizzes/{quiz}`](/merchant-api/reference/update-quiz) |
| `quiz:delete` | [`DELETE /products/{product}/attempts/{attempt}`](/merchant-api/reference/delete-attempt), [`DELETE /products/{product}/entries/{entry}/quizzes/{quiz}`](/merchant-api/reference/delete-quiz), [`POST /products/{product}/entries/{entry}/attempts/clear`](/merchant-api/reference/clear-attempts) |
| `review:read` | [`GET /reviews`](/merchant-api/reference/list-reviews), [`GET /products/{product}/reviews`](/merchant-api/reference/list-product-reviews), [`GET /reviews/stats`](/merchant-api/reference/review-stats), [`GET /products/{product}/reviews/stats`](/merchant-api/reference/product-review-stats) |
| `review:write` | [`POST /products/{product}/reviews/{review}/reply`](/merchant-api/reference/reply-to-review) |
| `review:moderate` | [`POST /products/{product}/reviews/{review}/hide`](/merchant-api/reference/hide-review), [`POST /products/{product}/reviews/{review}/unhide`](/merchant-api/reference/unhide-review) |
| `site:read` | [`GET /v1/stores/{store}`](/merchant-api/reference/get-store), [`GET /settings`](/merchant-api/reference/get-settings), [`GET /plan_usage`](/merchant-api/reference/get-plan-usage), [`GET /domain`](/merchant-api/reference/get-domain), [`GET /redirects`](/merchant-api/reference/list-redirects), [`GET /paths/check`](/merchant-api/reference/check-path) |
| `site:write` | [`PATCH /v1/stores/{store}`](/merchant-api/reference/update-store), [`PATCH /settings`](/merchant-api/reference/update-settings), [`POST /domain/connect`](/merchant-api/reference/connect-domain), [`POST /domain/check`](/merchant-api/reference/check-domain), [`POST /domain/remove`](/merchant-api/reference/remove-domain), [`PUT /icon`](/merchant-api/reference/set-store-icon), [`POST /redirects`](/merchant-api/reference/create-redirect), [`PATCH /redirects/{redirect}`](/merchant-api/reference/update-redirect) |
| `site:delete` | [`DELETE /redirects/{redirect}`](/merchant-api/reference/delete-redirect) |
| `subscription:read` | [`GET /subscriptions/stats`](/merchant-api/reference/subscription-stats), [`GET /subscriptions`](/merchant-api/reference/list-subscriptions), [`GET /subscription_periods`](/merchant-api/reference/list-subscription-periods), [`GET /subscription_transitions`](/merchant-api/reference/list-subscription-transitions), [`GET /subscriptions/{subscription}`](/merchant-api/reference/get-subscription) |
| `subscription:write` | [`POST /subscriptions/{subscription}/cancel`](/merchant-api/reference/cancel-subscription), [`POST /subscriptions/{subscription}/resume`](/merchant-api/reference/resume-subscription) |
| `transaction:read` | [`GET /stats`](/merchant-api/reference/store-stats), [`GET /orders/stats`](/merchant-api/reference/order-stats), [`GET /totals`](/merchant-api/reference/store-totals), [`GET /traffic/stats`](/merchant-api/reference/traffic-stats), [`GET /conversion/stats`](/merchant-api/reference/conversion-stats), [`GET /calls/stats`](/merchant-api/reference/call-stats), [`GET /orders`](/merchant-api/reference/list-orders), [`GET /orders/{order}`](/merchant-api/reference/get-order), [`GET /orders/{order}/items`](/merchant-api/reference/list-order-items), [`GET /orders/{order}/settlements`](/merchant-api/reference/list-order-settlements), [`GET /orders/{order}/refunds`](/merchant-api/reference/list-order-refunds), [`GET /orders/{order}/affiliates`](/merchant-api/reference/list-order-affiliates), [`GET /revocations`](/merchant-api/reference/list-revocations), [`GET /products/{product}/event_refunds`](/merchant-api/reference/list-event-refunds) |
| `transaction:write` | [`POST /orders`](/merchant-api/reference/record-order), [`POST /orders/{order}/refunds`](/merchant-api/reference/record-refund), [`POST /revocations`](/merchant-api/reference/create-revocation), [`POST /revocations/{revocation}/refund/retry`](/merchant-api/reference/retry-revocation-refund), [`POST /products/{product}/cancel`](/merchant-api/reference/cancel-event), [`POST /event_refunds/{refund}/retry`](/merchant-api/reference/retry-event-refund) |

## Operations that need more

- **Bulk.** <a href="/merchant-api/reference/bulk/">`POST /bulk`</a> names no scope of its own: it needs the scope of the operation it runs, `product:write` to publish products, checked before any item runs. See [bulk changes](/merchant-api/bulk).
- **Attachments and bodies.** What hangs on a product, an entry, a page, a quiz, a certificate, a holding or the store needs the file scope the operation names and also that target's own scope, `read` to read and `write` to change: `product`, `entry`, `custompage` (pages), `quiz`, `certificate`, `portfolio` (holdings) or `site` (the store). Attaching a file to an entry needs `file:write` and `entry:write`.
- **Prompts and thumbnails.** A product's prompts and its thumbnail need the file scope the operation names and the product's own too: `product:read` to read prompts, `product:write` to change them or the thumbnail. Their pages in the reference name both scopes.
- **Webhooks.** Creating an endpoint, adding events to it, resending a delivery or rolling its secret needs `organization:write` and the read scopes of the events' payloads, since what they send is read with your access. The [webhooks page](/merchant-api/webhooks#events) lists each event's.
- **Simulating an order.** <a href="/merchant-api/reference/simulate-checkout/">`GET /products/{product}/checkout/simulate`</a> needs `price:read`, plus `customer:read` to name a customer and `discount:read` to name a coupon. See [simulate an order](/merchant-api/guides/simulate-an-order).

## Scopes that change what you see

`revenue:read` is no operation's scope, but money follows it: without it, takings and fees come back as `null` wherever they appear (an order's amounts and lines, refunds, commissions, a product's or the store's stats), and sorting orders by `amount` or `fees` answers `403` with the reason `scope`, since the order would give the amounts away. Give it to a token that needs to see money.

Without `discount:read`, a simulated order still shows what its automatic discount takes off, but the discount's `id`, `name` and `code` come back as `null`.

## Scopes the API doesn't use

The `apitoken`, `client`, `member` and `user` scopes cover what only the merchant app does: API tokens, store API clients, the business's members and your own profile. An account token may hold them, since **Everything I can do** follows your seat, but they give it nothing on this API; a business token never holds the `apitoken` scopes.

Source: https://docs.sherpo.io/merchant-api/scopes/index.mdx
