generated: '2026-08-01'
method: searched
source: openapi/*.yml operation security[] requirements
docs: https://docs.constructor.com/reference/main-authentication#permissions-and-scopes
oauth2: false
scheme_type: http-bearer token permissions (NOT OAuth 2.0)
model: 'Constructor Bearer API tokens carry explicit permissions. A permission is {"scope": "<scope>",
  "operation": "r|w|rw", "resources": ["<API key>", ...]}. Scopes appear in the API reference in the form
  scope(r) / scope(w). A token lacking the required permission is rejected with 403 Forbidden; a missing
  or malformed token is rejected with 401 Unauthorized. `resources` currently accepts API keys, scoping
  a token to specific indexes.'
schemes:
- name: http_bearer_auth
  type: http
  scheme: bearer
  sources:
  - openapi/constructorio-autocomplete-openapi.yml
  - openapi/constructorio-browse-openapi.yml
  - openapi/constructorio-catalog-batching-openapi.yml
  - openapi/constructorio-catalog-management-openapi.yml
  - openapi/constructorio-configuration-openapi.yml
  - openapi/constructorio-image-search-openapi.yml
  - openapi/constructorio-product-details-openapi.yml
  - openapi/constructorio-recommendations-openapi.yml
  - openapi/constructorio-search-openapi.yml
  - openapi/constructorio-searchandising-openapi.yml
  - openapi/constructorio-user-profile-openapi.yml
- name: bearerAuth
  type: http
  scheme: bearer
  sources:
  - openapi/constructorio-retail-media-display-ads-openapi.yml
  - openapi/constructorio-retail-media-openapi.yml
scope_count: 37
scopes:
- scope: catalog(r)
  resource: catalog
  operation: read
  operation_count: 12
  operations:
  - v1-item-groups-retrieve-item-group
  - v1-item-groups-retrieve-item-groups
  - v1-items-fields-stats-retrieve-item-field-stats
  - v1-items-fields-stats-retrieve-items-fields-stats
  - v1-tasks-retrieve-task
  - v1-tasks-retrieve-tasks
  - v2-item-groups-retrieve-item-group
  - v2-item-groups-retrieve-item-groups
- scope: catalog(w)
  resource: catalog
  operation: write
  operation_count: 23
  operations:
  - v1-catalog-create-or-replace-catalog
  - v1-catalog-update-catalog
  - v1-item-groups-create-item-groups
  - v1-item-groups-create-or-replace-item-groups
  - v1-item-groups-create-or-update-item-group
  - v1-item-groups-create-or-update-item-groups
  - v1-item-groups-delete-item-groups
  - v1-tasks-create-task
- scope: collections(r)
  resource: collections
  operation: read
  operation_count: 3
  operations:
  - v1-collections-retrieve-collection
  - v1-collections-retrieve-collection-items
  - v1-collections-retrieve-collections
- scope: collections(w)
  resource: collections
  operation: write
  operation_count: 7
  operations:
  - v1-collections-create-collection
  - v1-collections-create-or-ignore-collection-items
  - v1-collections-delete-collection
  - v1-collections-delete-collection-item
  - v1-collections-delete-collection-items
  - v1-collections-replace-collection
  - v1-collections-update-collection
- scope: facets(r)
  resource: facets
  operation: read
  operation_count: 6
  operations:
  - v1-facet-options-retrieve-facet-option
  - v1-facet-options-retrieve-facet-options
  - v1-facets-retrieve-facet
  - v1-facets-retrieve-facets
  - v2-facets-retrieve-facet
  - v2-facets-retrieve-facets
- scope: facets(w)
  resource: facets
  operation: write
  operation_count: 17
  operations:
  - v1-facet-options-create-facet-option
  - v1-facet-options-create-or-update-facet-options
  - v1-facet-options-delete-facet-option
  - v1-facet-options-replace-facet-option
  - v1-facet-options-update-facet-option
  - v1-facets-create-facet
  - v1-facets-create-or-replace-facets
  - v1-facets-delete-facet
- scope: facets.refined_filters(r)
  resource: facets.refined_filters
  operation: read
  operation_count: 4
  operations:
  - v1-searchandising-get-facet-rule-campaign
  - v1-searchandising-retrieve-facet-rule-campaigns
  - v1-searchandising-retrieve-refined-filter
  - v1-searchandising-retrieve-refined-filters
- scope: facets.refined_filters(w)
  resource: facets.refined_filters
  operation: write
  operation_count: 5
  operations:
  - v1-searchandising-create-facet-rule-campaign
  - v1-searchandising-create-or-replace-refined-filter
  - v1-searchandising-delete-facet-rule-campaign
  - v1-searchandising-delete-refined-filter-rules
  - v1-searchandising-update-facet-rule-campaign
- scope: facets.refined_queries(r)
  resource: facets.refined_queries
  operation: read
  operation_count: 4
  operations:
  - v1-searchandising-get-facet-rule-campaign
  - v1-searchandising-retrieve-facet-rule-campaigns
  - v1-searchandising-retrieve-refined-queries
  - v1-searchandising-retrieve-refined-query
- scope: facets.refined_queries(w)
  resource: facets.refined_queries
  operation: write
  operation_count: 5
  operations:
  - v1-searchandising-create-facet-rule-campaign
  - v1-searchandising-create-refined-query
  - v1-searchandising-delete-facet-rule-campaign
  - v1-searchandising-replace-refined-query
  - v1-searchandising-update-facet-rule-campaign
- scope: metadata_overrides(r)
  resource: metadata_overrides
  operation: read
  operation_count: 1
  operations:
  - metadata-overrides-get-metadata-overrides
- scope: metadata_overrides(w)
  resource: metadata_overrides
  operation: write
  operation_count: 3
  operations:
  - metadata-overrides-delete-metadata-override
  - metadata-overrides-patch-metadata-override
  - metadata-overrides-post-metadata-override
- scope: quizzes(r)
  resource: quizzes
  operation: read
  operation_count: 1
  operations:
  - v1-quizzes-retrieve-quiz
- scope: quizzes(w)
  resource: quizzes
  operation: write
  operation_count: 3
  operations:
  - v1-quizzes-create-or-replace-quiz
  - v1-quizzes-delete-quiz
  - v1-quizzes-update-quiz
- scope: redirects(r)
  resource: redirects
  operation: read
  operation_count: 2
  operations:
  - v1-redirects-retrieve-redirect-rule
  - v1-redirects-retrieve-redirect-rules
- scope: redirects(w)
  resource: redirects
  operation: write
  operation_count: 4
  operations:
  - v1-redirects-create-redirect-rule
  - v1-redirects-delete-redirect-rule
  - v1-redirects-replace-redirect-rule
  - v1-redirects-update-redirect-rule
- scope: retail_media.ad_spend_tracking(r)
  resource: retail_media.ad_spend_tracking
  operation: read
  operation_count: 1
  operations:
  - v1-advertiser-spend-retrieve-advertiser-spend
- scope: retail_media.engagements(w)
  resource: retail_media.engagements
  operation: write
  operation_count: 1
  operations:
  - v1-engagements-update
- scope: search_suggestions(w)
  resource: search_suggestions
  operation: write
  operation_count: 8
  operations:
  - v1-catalog-create-or-replace-catalog
  - v1-catalog-update-catalog
  - v2-items-create-or-replace-items
  - v2-items-delete-items
  - v2-items-update-items
  - v2-variations-create-or-replace-variations
  - v2-variations-delete-variations
  - v2-variations-update-variations
- scope: searchabilities(r)
  resource: searchabilities
  operation: read
  operation_count: 4
  operations:
  - v1-searchabilities-retrieve-searchabilities
  - v1-searchabilities-retrieve-searchability
  - v2-searchabilities-retrieve-searchabilities
  - v2-searchabilities-retrieve-searchability
- scope: searchabilities(w)
  resource: searchabilities
  operation: write
  operation_count: 8
  operations:
  - v1-searchabilities-create-or-update-searchabilities
  - v1-searchabilities-create-or-update-searchability
  - v1-searchabilities-delete-searchabilities
  - v1-searchabilities-delete-searchability
  - v2-searchabilities-create-or-update-searchabilities
  - v2-searchabilities-create-or-update-searchability
  - v2-searchabilities-delete-searchabilities
  - v2-searchabilities-delete-searchability
- scope: searchandising.campaigns(r)
  resource: searchandising.campaigns
  operation: read
  operation_count: 2
  operations:
  - v1-searchandising-retrieve-campaign
  - v1-searchandising-retrieve-campaigns
- scope: searchandising.campaigns(w)
  resource: searchandising.campaigns
  operation: write
  operation_count: 3
  operations:
  - v1-searchandising-create-campaign
  - v1-searchandising-delete-campaign
  - v1-searchandising-update-campaign
- scope: searchandising.recommendations(r)
  resource: searchandising.recommendations
  operation: read
  operation_count: 2
  operations:
  - v1-searchandising-retrieve-campaign
  - v1-searchandising-retrieve-campaigns
- scope: searchandising.recommendations(w)
  resource: searchandising.recommendations
  operation: write
  operation_count: 3
  operations:
  - v1-searchandising-create-campaign
  - v1-searchandising-delete-campaign
  - v1-searchandising-update-campaign
- scope: searchandising.refined_collections(r)
  resource: searchandising.refined_collections
  operation: read
  operation_count: 2
  operations:
  - v1-searchandising-retrieve-refined-collection
  - v1-searchandising-retrieve-refined-collections
- scope: searchandising.refined_collections(w)
  resource: searchandising.refined_collections
  operation: write
  operation_count: 3
  operations:
  - v1-searchandising-create-or-replace-refined-collection
  - v1-searchandising-delete-refined-collection
  - v1-searchandising-update-refined-collection
- scope: searchandising.refined_filters(r)
  resource: searchandising.refined_filters
  operation: read
  operation_count: 3
  operations:
  - v1-searchandising-retrieve-refined-filter
  - v1-searchandising-retrieve-refined-filter-rules
  - v1-searchandising-retrieve-refined-filters
- scope: searchandising.refined_filters(w)
  resource: searchandising.refined_filters
  operation: write
  operation_count: 4
  operations:
  - v1-searchandising-create-or-replace-refined-filter
  - v1-searchandising-delete-refined-filter
  - v1-searchandising-delete-refined-filter-rules
  - v1-searchandising-update-refined-filter
- scope: searchandising.refined_queries(r)
  resource: searchandising.refined_queries
  operation: read
  operation_count: 2
  operations:
  - v1-searchandising-retrieve-refined-queries
  - v1-searchandising-retrieve-refined-query
- scope: searchandising.refined_queries(w)
  resource: searchandising.refined_queries
  operation: write
  operation_count: 4
  operations:
  - v1-searchandising-create-refined-query
  - v1-searchandising-delete-refined-query
  - v1-searchandising-replace-refined-query
  - v1-searchandising-update-refined-query
- scope: searchandising.refined_tags(r)
  resource: searchandising.refined_tags
  operation: read
  operation_count: 2
  operations:
  - v1-searchandising-retreive-refined-tags
  - v1-searchandising-retrieve-refined-tag
- scope: searchandising.refined_tags(w)
  resource: searchandising.refined_tags
  operation: write
  operation_count: 3
  operations:
  - v1-searchandising-create-or-replace-refined-tag
  - v1-searchandising-delete-refined-tag
  - v1-searchandising-update-refined-tag
- scope: sort_options(r)
  resource: sort_options
  operation: read
  operation_count: 1
  operations:
  - v1-sort-options-retrieve-sort-options
- scope: sort_options(w)
  resource: sort_options
  operation: write
  operation_count: 5
  operations:
  - v1-sort-options-create-or-replace-sort-option
  - v1-sort-options-create-or-replace-sort-options
  - v1-sort-options-create-sort-option
  - v1-sort-options-delete-sort-options
  - v1-sort-options-update-sort-option
- scope: synonyms(r)
  resource: synonyms
  operation: read
  operation_count: 4
  operations:
  - v1-synonyms-list-synonyms
  - v1-synonyms-retrieve-synonym
  - v2-one-way-synonyms-retrieve-one-way-synonym
  - v2-one-way-synonyms-retrieve-one-way-synonyms
- scope: synonyms(w)
  resource: synonyms
  operation: write
  operation_count: 8
  operations:
  - v1-synonyms-create-synonym
  - v1-synonyms-delete-synonym
  - v1-synonyms-delete-synonyms
  - v1-synonyms-update-synonym
  - v2-one-way-synonyms-create-one-way-synonym
  - v2-one-way-synonyms-delete-one-way-synonym
  - v2-one-way-synonyms-delete-one-way-synonyms
  - v2-one-way-synonyms-replace-one-way-synonym