Skip to content

armgit / spree

Public Imported from GitHub
0

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

Add Allowed Origins management to Admin API / SDK and SPA dashboard (#14100)

Damian Legawiec6f6bfbb1596d
diff --git a/docs/api-reference/admin.yaml b/docs/api-reference/admin.yaml
index 24e1ceb875..a996638b21 100644
--- a/docs/api-reference/admin.yaml
+++ b/docs/api-reference/admin.yaml
@@ -82,12 +82,12 @@ paths:
example:
data:
- id: admin_UkLWZg9DAJ
- first_name: Modesta
- last_name: Walker
- full_name: Modesta Walker
- created_at: '2026-05-26T16:11:55.501Z'
- updated_at: '2026-05-26T16:11:55.501Z'
+ first_name: Hyman
+ last_name: Wisoky
+ full_name: Hyman Wisoky
+ created_at: '2026-05-26T17:51:43.945Z'
+ updated_at: '2026-05-26T17:51:43.945Z'
roles:
- id: role_UkLWZg9DAJ
name: admin
@@ -145,12 +145,12 @@ paths:
application/json:
example:
id: admin_UkLWZg9DAJ
- first_name: Jordan
- last_name: Herman
- full_name: Jordan Herman
- created_at: '2026-05-26T16:11:55.855Z'
- updated_at: '2026-05-26T16:11:55.855Z'
+ first_name: Danelle
+ last_name: Mitchell
+ full_name: Danelle Mitchell
+ created_at: '2026-05-26T17:51:44.291Z'
+ updated_at: '2026-05-26T17:51:44.291Z'
roles:
- id: role_UkLWZg9DAJ
name: admin
@@ -203,12 +203,12 @@ paths:
application/json:
example:
id: admin_UkLWZg9DAJ
first_name: Renamed
- last_name: Reichel
- full_name: Renamed Reichel
- created_at: '2026-05-26T16:11:56.204Z'
- updated_at: '2026-05-26T16:11:56.238Z'
+ last_name: Mayert
+ full_name: Renamed Mayert
+ created_at: '2026-05-26T17:51:44.574Z'
+ updated_at: '2026-05-26T17:51:44.591Z'
roles:
- id: role_UkLWZg9DAJ
name: admin
@@ -270,6 +270,384 @@ paths:
responses:
'204':
description: staff removed from store
+ "/api/v3/admin/allowed_origins":
+ get:
+ summary: List allowed origins
+ tags:
+ - Configuration
+ security:
+ - api_key: []
+ bearer_auth: []
+ description: |-
+ Returns the CORS allowlist for the current store. Each entry is a
+ bare `scheme://host[:port]` permitted to call the admin API from a
+ browser. Backs the `Rack::Cors` allowlist and the CSRF boundary of
+ the admin cookie session (see
+ `docs/plans/5.5-admin-auth-cookie-refresh.md`).
+
+
+ **Required scope:** `read_settings` (for API-key authentication).
+ x-codeSamples:
+ - lang: javascript
+ label: Spree Admin SDK
+ source: |-
+ import { createAdminClient } from '@spree/admin-sdk'
+
+ const client = createAdminClient({
+ baseUrl: 'https://your-store.com',
+ secretKey: 'sk_xxx',
+ })
+
+ const { data: origins } = await client.allowedOrigins.list()
+ parameters:
+ - name: x-spree-api-key
+ in: header
+ required: true
+ schema:
+ type: string
+ - name: Authorization
+ in: header
+ required: true
+ description: Bearer token for admin authentication
+ schema:
+ type: string
+ - name: page
+ in: query
+ required: false
+ description: Page number
+ schema:
+ type: integer
+ - name: limit
+ in: query
+ required: false
+ description: Number of records per page
+ schema:
+ type: integer
+ - name: q[origin_cont]
+ in: query
+ required: false
+ description: Filter by origin (contains)
+ schema:
+ type: string
+ - name: sort
+ in: query
+ required: false
+ description: Sort by field. Prefix with `-` for descending (e.g., `-created_at`).
+ schema:
+ type: string
+ - name: fields
+ in: query
+ required: false
+ description: Comma-separated list of fields to include. id is always included.
+ schema:
+ type: string
+ responses:
+ '200':
+ description: allowed origins found
+ content:
+ application/json:
+ example:
+ data:
+ - id: ao_UkLWZg9DAJ
+ origin: https://shop.example.com
+ created_at: '2026-05-26T17:51:44.888Z'
+ updated_at: '2026-05-26T17:51:44.888Z'
+ store_id: store_UkLWZg9DAJ
+ meta:
+ page: 1
+ limit: 25
+ count: 1
+ pages: 1
+ from: 1
+ to: 1
+ in: 1
+ previous:
+ next:
+ schema:
+ type: object
+ properties:
+ data:
+ type: array
+ items:
+ "$ref": "#/components/schemas/AllowedOrigin"
+ meta:
+ "$ref": "#/components/schemas/PaginationMeta"
+ required:
+ - data
+ - meta
+ '401':
+ description: unauthorized
+ content:
+ application/json:
+ example:
+ error:
+ code: authentication_required
+ message: Authentication required
+ schema:
+ "$ref": "#/components/schemas/ErrorResponse"
+ post:
+ summary: Create an allowed origin
+ tags:
+ - Configuration
+ security:
+ - api_key: []
+ bearer_auth: []
+ description: |-
+ Adds an origin to the admin CORS allowlist. The value must be a bare
+ `scheme://host[:port]` (no path, query, or fragment) and use `http` or
+ `https`.
+
+
+ **Required scope:** `write_settings` (for API-key authentication).
+ x-codeSamples:
+ - lang: javascript
+ label: Spree Admin SDK
+ source: |-
+ import { createAdminClient } from '@spree/admin-sdk'
+
+ const client = createAdminClient({
+ baseUrl: 'https://your-store.com',
+ secretKey: 'sk_xxx',
+ })
+
+ const origin = await client.allowedOrigins.create({
+ origin: 'https://admin.example.com',
+ })
+ parameters:
+ - name: x-spree-api-key
+ in: header
+ required: true
+ schema:
+ type: string
+ - name: Authorization
+ in: header
+ required: true
+ description: Bearer token for admin authentication
+ schema:
+ type: string
+ responses:
+ '201':
+ description: allowed origin created
+ content:
+ application/json:
+ example:
+ id: ao_gbHJdmfrXB
+ origin: https://admin.example.com
+ created_at: '2026-05-26T17:51:45.503Z'
+ updated_at: '2026-05-26T17:51:45.503Z'
+ store_id: store_UkLWZg9DAJ
+ schema:
+ "$ref": "#/components/schemas/AllowedOrigin"
+ '422':
+ description: validation error
+ content:
+ application/json:
+ example:
+ error:
+ code: validation_error
+ message: Origin is invalid
+ details:
+ origin:
+ - is invalid
+ schema:
+ "$ref": "#/components/schemas/ErrorResponse"
+ requestBody:
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ origin:
+ type: string
+ example: https://admin.example.com
+ required:
+ - origin
+ "/api/v3/admin/allowed_origins/{id}":
+ parameters:
+ - name: id
+ in: path
+ required: true
+ description: Allowed origin ID
+ schema:
+ type: string
+ get:
+ summary: Get an allowed origin
+ tags:
+ - Configuration
+ security:
+ - api_key: []
+ bearer_auth: []
+ description: |-
+ Returns a single allowed origin by prefixed ID.
+
+ **Required scope:** `read_settings` (for API-key authentication).
+ x-codeSamples:
+ - lang: javascript
+ label: Spree Admin SDK
+ source: |-
+ import { createAdminClient } from '@spree/admin-sdk'
+
+ const client = createAdminClient({
+ baseUrl: 'https://your-store.com',
+ secretKey: 'sk_xxx',
+ })
+
+ const origin = await client.allowedOrigins.get('ao_xxx')
+ parameters:
+ - name: x-spree-api-key
+ in: header
+ required: true
+ schema:
+ type: string
+ - name: Authorization
+ in: header
+ required: true
+ description: Bearer token for admin authentication
+ schema:
+ type: string
+ - name: fields
+ in: query
+ required: false
+ description: Comma-separated list of fields to include. id is always included.
+ schema:
+ type: string
+ responses:
+ '200':
+ description: allowed origin found
+ content:
+ application/json:
+ example:
+ id: ao_UkLWZg9DAJ
+ origin: https://shop.example.com
+ created_at: '2026-05-26T17:51:45.800Z'
+ updated_at: '2026-05-26T17:51:45.800Z'
+ store_id: store_UkLWZg9DAJ
+ schema:
+ "$ref": "#/components/schemas/AllowedOrigin"
+ '404':
+ description: allowed origin not found
+ content:
+ application/json:
+ example:
+ error:
+ code: record_not_found
+ message: Allowed origin not found
+ schema:
+ "$ref": "#/components/schemas/ErrorResponse"
+ patch:
+ summary: Update an allowed origin
+ tags:
+ - Configuration
+ security:
+ - api_key: []
+ bearer_auth: []
+ description: |-
+ Updates an existing allowed origin.
+
+ **Required scope:** `write_settings` (for API-key authentication).
+ x-codeSamples:
+ - lang: javascript
+ label: Spree Admin SDK
+ source: |-
+ import { createAdminClient } from '@spree/admin-sdk'
+
+ const client = createAdminClient({
+ baseUrl: 'https://your-store.com',
+ secretKey: 'sk_xxx',
+ })
+
+ const origin = await client.allowedOrigins.update('ao_xxx', {
+ origin: 'https://www.example.com',
+ })
+ parameters:
+ - name: x-spree-api-key
+ in: header
+ required: true
+ schema:
+ type: string
+ - name: Authorization
+ in: header
+ required: true
+ description: Bearer token for admin authentication
+ schema:
+ type: string
+ responses:
+ '200':
+ description: allowed origin updated
+ content:
+ application/json:
+ example:
+ id: ao_UkLWZg9DAJ
+ origin: https://www.example.com
+ created_at: '2026-05-26T17:51:46.386Z'
+ updated_at: '2026-05-26T17:51:46.666Z'
+ store_id: store_UkLWZg9DAJ
+ schema:
+ "$ref": "#/components/schemas/AllowedOrigin"
+ '422':
+ description: validation error
+ content:
+ application/json:
+ example:
+ error:
+ code: validation_error
+ message: Origin must be an origin (scheme and host) without path,
+ query, or fragment
+ details:
+ origin:
+ - must be an origin (scheme and host) without path, query, or
+ fragment
+ schema:
+ "$ref": "#/components/schemas/ErrorResponse"
+ requestBody:
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ origin:
+ type: string
+ delete:
+ summary: Delete an allowed origin
+ tags:
+ - Configuration
+ security:
+ - api_key: []
+ bearer_auth: []
+ description: |-
+ Removes an origin from the admin CORS allowlist. After deletion the
+ admin SPA running at that origin will no longer be able to call the
+ admin API from a browser.
+
+
+ **Required scope:** `write_settings` (for API-key authentication).
+ x-codeSamples:
+ - lang: javascript
+ label: Spree Admin SDK
+ source: |-
+ import { createAdminClient } from '@spree/admin-sdk'
+
+ const client = createAdminClient({
+ baseUrl: 'https://your-store.com',
+ secretKey: 'sk_xxx',
+ })
+
+ await client.allowedOrigins.delete('ao_xxx')
+ parameters:
+ - name: x-spree-api-key
+ in: header
+ required: true
+ schema:
+ type: string
+ - name: Authorization
+ in: header
+ required: true
+ description: Bearer token for admin authentication
+ schema:
+ type: string
+ responses:
+ '204':
+ description: allowed origin deleted
"/api/v3/admin/api_keys":
get:
summary: List API keys
@@ -317,32 +695,32 @@ paths:
key_type: publishable
token_prefix:
scopes: []
- created_at: '2026-05-26T16:11:56.556Z'
- updated_at: '2026-05-26T16:11:56.556Z'
+ created_at: '2026-05-26T17:51:47.237Z'
+ updated_at: '2026-05-26T17:51:47.237Z'
revoked_at:
last_used_at:
- plaintext_token: pk_sMAe8wVfz8C8UEma1dzHXGuB
+ plaintext_token: pk_2nWj5LxXd1obzqvKKkk6brH8
created_by_email:
- id: key_gbHJdmfrXB
name: Backend integration
key_type: secret
- token_prefix: sk_8GrpM2be2
+ token_prefix: sk_3DtN5o12E
scopes:
- write_all
- created_at: '2026-05-26T16:11:56.558Z'
- updated_at: '2026-05-26T16:11:56.558Z'
+ created_at: '2026-05-26T17:51:47.238Z'
+ updated_at: '2026-05-26T17:51:47.238Z'
revoked_at:
last_used_at:
plaintext_token:
created_by_email:
- id: key_EfhxLZ9ck8
- name: libero
+ name: eligendi
key_type: secret
- token_prefix: sk_53SjiyxYD
+ token_prefix: sk_xQrDU8fnA
scopes:
- write_all
- created_at: '2026-05-26T16:11:56.560Z'
- updated_at: '2026-05-26T16:11:56.560Z'
+ created_at: '2026-05-26T17:51:47.239Z'
+ updated_at: '2026-05-26T17:51:47.239Z'
revoked_at:
last_used_at:
plaintext_token:
@@ -405,15 +783,15 @@ paths:
id: key_VqXmZF31wY
name: CI key
key_type: secret
- token_prefix: sk_d2znVaYUc
+ token_prefix: sk_KdGp89shD
scopes:
- read_orders
- created_at: '2026-05-26T16:11:57.239Z'
- updated_at: '2026-05-26T16:11:57.239Z'
+ created_at: '2026-05-26T17:51:47.794Z'
+ updated_at: '2026-05-26T17:51:47.794Z'
revoked_at:
last_used_at:
- plaintext_token: sk_d2znVaYUcjv7xLXu7gNm1vGc
- created_by_email: [email protected]
+ plaintext_token: sk_KdGp89shDKVMXD259UdFy5Lc
+ created_by_email: [email protected]
'422':
description: validation error
content:
@@ -499,11 +877,11 @@ paths:
key_type: publishable
token_prefix:
scopes: []
- created_at: '2026-05-26T16:11:57.532Z'
- updated_at: '2026-05-26T16:11:57.532Z'
+ created_at: '2026-05-26T17:51:48.080Z'
+ updated_at: '2026-05-26T17:51:48.080Z'
revoked_at:
last_used_at:
- plaintext_token: pk_VMqsBqSQyYziwRjbWKTyNd5h
+ plaintext_token: pk_QT4q9KmVzWPhZ2fXdrtnJ5G7
created_by_email:
delete:
summary: Delete an API key
@@ -593,12 +971,12 @@ paths:
id: key_gbHJdmfrXB
name: Backend integration
key_type: secret
- token_prefix: sk_LMPdjpQhR
+ token_prefix: sk_ZVE6hY8P7
scopes:
- write_all
- created_at: '2026-05-26T16:11:58.097Z'
- updated_at: '2026-05-26T16:11:58.376Z'
- revoked_at: '2026-05-26T16:11:58.374Z'
+ created_at: '2026-05-26T17:51:48.641Z'
+ updated_at: '2026-05-26T17:51:48.940Z'
+ revoked_at: '2026-05-26T17:51:48.938Z'
last_used_at:
plaintext_token:
created_by_email:
@@ -652,15 +1030,15 @@ paths:
content:
application/json:
example:
- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6IjFiOTNkNjUzLTU0NmMtNDhlYS1hZDRiLWE1NWU5OTY0YzZkZCIsImlzcyI6InNwcmVlIiwiYXVkIjoiYWRtaW5fYXBpIiwiZXhwIjoxNzc5ODEyMjE4fQ.FSbBqYArfkNhx4AOUgjEQi8EtOuiO0OJFtWwIfgDJkQ
+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6ImJlYjU3YjA2LTNiZjgtNDgxYi1iNmY4LTcwNzliOGNiNGU4MSIsImlzcyI6InNwcmVlIiwiYXVkIjoiYWRtaW5fYXBpIiwiZXhwIjoxNzc5ODE4MjA5fQ.yft3mtd1fj2Kf4ym2orSz3LPWQNUHeSWnQHBwn1sE2I
user:
id: admin_UkLWZg9DAJ
- first_name: Ruby
- last_name: Frami
- full_name: Ruby Frami
- created_at: '2026-05-26T16:11:58.643Z'
- updated_at: '2026-05-26T16:11:58.643Z'
+ first_name: Omer
+ last_name: Tillman
+ full_name: Omer Tillman
+ created_at: '2026-05-26T17:51:49.205Z'
+ updated_at: '2026-05-26T17:51:49.205Z'
roles:
- id: role_UkLWZg9DAJ
name: admin
@@ -755,15 +1133,15 @@ paths:
content:
application/json:
example:
- token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6IjNhMWI5M2M4LWM2Y2UtNGNhMy04NmNkLTRjZjFlZGZjNjczNSIsImlzcyI6InNwcmVlIiwiYXVkIjoiYWRtaW5fYXBpIiwiZXhwIjoxNzc5ODEyMjE5fQ.hxO8Fmk8Emo9J8B2jWENXY8VDb0NSV8JnzvOpqR3m44
+ token: eyJhbGciOiJIUzI1NiJ9.eyJ1c2VyX2lkIjoxLCJ1c2VyX3R5cGUiOiJhZG1pbiIsImp0aSI6ImE4YWZiMWQ1LTJhYTAtNDE2ZC05MjQ3LTM0ZTUwNzg2YzliOSIsImlzcyI6InNwcmVlIiwiYXVkIjoiYWRtaW5fYXBpIiwiZXhwIjoxNzc5ODE4MjEwfQ.omcSpKy4n6DX29XitxnnV6zPFoMpJIou2Uq0oBK8J2A
user:
id: admin_UkLWZg9DAJ
- first_name: Melissa
- last_name: Hills
- full_name: Melissa Hills
- created_at: '2026-05-26T16:11:59.743Z'
- updated_at: '2026-05-26T16:11:59.743Z'
+ first_name: Ellis
+ last_name: Steuber
+ full_name: Ellis Steuber
+ created_at: '2026-05-26T17:51:50.363Z'
+ updated_at: '2026-05-26T17:51:50.363Z'
roles:
- id: role_UkLWZg9DAJ
name: admin
@@ -860,15 +1238,15 @@ paths:
- id: coupon_UkLWZg9DAJ
code: AAA111
state: unused
- created_at: '2026-05-26T16:12:00.430Z'
- updated_at: '2026-05-26T16:12:00.430Z'
+ created_at: '2026-05-26T17:51:50.965Z'
+ updated_at: '2026-05-26T17:51:50.965Z'
promotion_id: promo_UkLWZg9DAJ
order_id:
- id: coupon_gbHJdmfrXB
code: BBB222
state: unused
- created_at: '2026-05-26T16:12:00.431Z'
- updated_at: '2026-05-26T16:12:00.431Z'
+ created_at: '2026-05-26T17:51:50.966Z'
+ updated_at: '2026-05-26T17:51:50.966Z'
promotion_id: promo_UkLWZg9DAJ
order_id:
meta:
@@ -946,8 +1324,8 @@ paths:
field_type: short_text
resource_type: Spree::Product
storefront_visible: true
- created_at: '2026-05-26T16:12:00.726Z'
- updated_at: '2026-05-26T16:12:00.726Z'
+ created_at: '2026-05-26T17:51:51.264Z'
+ updated_at: '2026-05-26T17:51:51.264Z'
- id: cfdef_gbHJdmfrXB
namespace: custom
key: order_notes
@@ -955,8 +1333,8 @@ paths:
field_type: short_text
resource_type: Spree::Order
storefront_visible: true
- created_at: '2026-05-26T16:12:00.727Z'
- updated_at: '2026-05-26T16:12:00.727Z'
+ created_at: '2026-05-26T17:51:51.265Z'
+ updated_at: '2026-05-26T17:51:51.265Z'
meta:
page: 1
limit: 25
@@ -1019,8 +1397,8 @@ paths:
field_type: short_text
resource_type: Spree::Product
storefront_visible: true
- created_at: '2026-05-26T16:12:01.285Z'
- updated_at: '2026-05-26T16:12:01.285Z'
+ created_at: '2026-05-26T17:51:51.830Z'
+ updated_at: '2026-05-26T17:51:51.830Z'
requestBody:
content:
application/json:
@@ -1103,8 +1481,8 @@ paths:
field_type: short_text
resource_type: Spree::Product
storefront_visible: true
- created_at: '2026-05-26T16:12:01.288Z'
- updated_at: '2026-05-26T16:12:01.288Z'
+ created_at: '2026-05-26T17:51:51.833Z'
+ updated_at: '2026-05-26T17:51:51.833Z'
patch:
summary: Update a custom field definition
tags:
@@ -1143,8 +1521,8 @@ paths:
field_type: short_text
resource_type: Spree::Product
storefront_visible: false
- created_at: '2026-05-26T16:12:01.575Z'
- updated_at: '2026-05-26T16:12:01.862Z'
+ created_at: '2026-05-26T17:51:52.140Z'
+ updated_at: '2026-05-26T17:51:52.427Z'
requestBody:
content:
application/json:
@@ -1268,14 +1646,14 @@ paths:
name: VIPs
description: Top spenders
customers_count: 0
- created_at: '2026-05-26T16:12:02.163Z'
- updated_at: '2026-05-26T16:12:02.163Z'
+ created_at: '2026-05-26T17:51:52.728Z'
+ updated_at: '2026-05-26T17:51:52.728Z'
- id: cg_gbHJdmfrXB
name: Wholesale
description:
customers_count: 0
- created_at: '2026-05-26T16:12:02.164Z'
- updated_at: '2026-05-26T16:12:02.164Z'
+ created_at: '2026-05-26T17:51:52.730Z'
+ updated_at: '2026-05-26T17:51:52.730Z'
meta:
page: 1
limit: 25
@@ -1360,8 +1738,8 @@ paths:
name: Wholesale 2
description: B2B accounts
customers_count: 1
- created_at: '2026-05-26T16:12:03.069Z'
- updated_at: '2026-05-26T16:12:03.069Z'
+ created_at: '2026-05-26T17:51:53.597Z'
+ updated_at: '2026-05-26T17:51:53.597Z'
schema:
"$ref": "#/components/schemas/CustomerGroup"
'422':
@@ -1467,24 +1845,24 @@ paths:
name: VIPs
description: Top spenders
customers_count: 1
- created_at: '2026-05-26T16:12:03.679Z'
- updated_at: '2026-05-26T16:12:03.679Z'
+ created_at: '2026-05-26T17:51:54.171Z'
+ updated_at: '2026-05-26T17:51:54.171Z'
customers:
- id: cus_UkLWZg9DAJ
- first_name: Avelina
- last_name: Weber
+ first_name: Halina
+ last_name: Stracke
phone:
accepts_email_marketing: false
- full_name: Avelina Weber
+ full_name: Halina Stracke
available_store_credit_total: '0'
display_available_store_credit_total: "$0.00"
metadata: {}
last_sign_in_at:
current_sign_in_at:
- created_at: '2026-05-26T16:12:03.948Z'
- updated_at: '2026-05-26T16:12:03.948Z'
+ created_at: '2026-05-26T17:51:54.459Z'
+ updated_at: '2026-05-26T17:51:54.459Z'
sign_in_count: 0
failed_attempts: 0
last_sign_in_ip:
@@ -1562,8 +1940,8 @@ paths:
name: VIP customers (Q1)
description: Top spenders
customers_count: 0
- created_at: '2026-05-26T16:12:04.532Z'
- updated_at: '2026-05-26T16:12:04.839Z'
+ created_at: '2026-05-26T17:51:55.041Z'
+ updated_at: '2026-05-26T17:51:55.321Z'
schema:
"$ref": "#/components/schemas/CustomerGroup"
'422':
@@ -1716,8 +2094,8 @@ paths:
state_name: New York
label:
metadata: {}
- created_at: '2026-05-26T16:12:05.803Z'
- updated_at: '2026-05-26T16:12:05.803Z'
+ created_at: '2026-05-26T17:51:56.186Z'
+ updated_at: '2026-05-26T17:51:56.186Z'
customer_id: cus_UkLWZg9DAJ
meta:
page: 1
@@ -1805,8 +2183,8 @@ paths:
state_name: New York
label: Office
metadata: {}
- created_at: '2026-05-26T16:12:07.161Z'
- updated_at: '2026-05-26T16:12:07.161Z'
+ created_at: '2026-05-26T17:51:57.549Z'
+ updated_at: '2026-05-26T17:51:57.549Z'
customer_id: cus_UkLWZg9DAJ
requestBody:
content:
@@ -1917,8 +2295,8 @@ paths:
state_name: New York
label:
metadata: {}
- created_at: '2026-05-26T16:12:07.438Z'
- updated_at: '2026-05-26T16:12:08.064Z'
+ created_at: '2026-05-26T17:51:57.818Z'
+ updated_at: '2026-05-26T17:51:58.361Z'
customer_id: cus_UkLWZg9DAJ
requestBody:
content:
@@ -2051,8 +2429,8 @@ paths:
customer_id: cus_UkLWZg9DAJ
payment_method_id: pm_UkLWZg9DAJ
metadata: {}
- created_at: '2026-05-26T16:12:09.473Z'
- updated_at: '2026-05-26T16:12:09.473Z'
+ created_at: '2026-05-26T17:51:59.488Z'
+ updated_at: '2026-05-26T17:51:59.488Z'
meta:
page: 1
limit: 25
@@ -2139,8 +2517,8 @@ paths:
customer_id: cus_UkLWZg9DAJ
payment_method_id: pm_UkLWZg9DAJ
metadata: {}
- created_at: '2026-05-26T16:12:10.055Z'
- updated_at: '2026-05-26T16:12:10.055Z'
+ created_at: '2026-05-26T17:52:00.041Z'
+ updated_at: '2026-05-26T17:52:00.041Z'
delete:
summary: Delete a customer credit card
tags:
@@ -2259,8 +2637,8 @@ paths:
currency: USD
memo:
metadata: {}
- created_at: '2026-05-26T16:12:11.460Z'
- updated_at: '2026-05-26T16:12:11.460Z'
+ created_at: '2026-05-26T17:52:01.409Z'
+ updated_at: '2026-05-26T17:52:01.409Z'
customer_id: cus_UkLWZg9DAJ
created_by_id: admin_UkLWZg9DAJ
category_id: sccat_UkLWZg9DAJ
@@ -2335,8 +2713,8 @@ paths:
currency: USD
memo: Goodwill
metadata: {}
- created_at: '2026-05-26T16:12:12.603Z'
- updated_at: '2026-05-26T16:12:12.603Z'
+ created_at: '2026-05-26T17:52:02.531Z'
+ updated_at: '2026-05-26T17:52:02.531Z'
customer_id: cus_UkLWZg9DAJ
created_by_id: admin_gbHJdmfrXB
category_id: sccat_UkLWZg9DAJ
@@ -2427,8 +2805,8 @@ paths:
currency: USD
memo: Updated
metadata: {}
- created_at: '2026-05-26T16:12:13.232Z'
- updated_at: '2026-05-26T16:12:13.518Z'
+ created_at: '2026-05-26T17:52:03.094Z'
+ updated_at: '2026-05-26T17:52:03.378Z'
customer_id: cus_UkLWZg9DAJ
created_by_id: admin_UkLWZg9DAJ
category_id: sccat_UkLWZg9DAJ
@@ -2582,8 +2960,8 @@ paths:
metadata: {}
last_sign_in_at:
current_sign_in_at:
- created_at: '2026-05-26T16:12:14.666Z'
- updated_at: '2026-05-26T16:12:14.666Z'
+ created_at: '2026-05-26T17:52:04.460Z'
+ updated_at: '2026-05-26T17:52:04.460Z'
sign_in_count: 0
failed_attempts: 0
last_sign_in_ip:
@@ -2666,8 +3044,8 @@ paths:
metadata: {}
last_sign_in_at:
current_sign_in_at:
- created_at: '2026-05-26T16:12:15.501Z'
- updated_at: '2026-05-26T16:12:15.501Z'
+ created_at: '2026-05-26T17:52:05.293Z'
+ updated_at: '2026-05-26T17:52:05.293Z'
sign_in_count: 0
failed_attempts: 0
last_sign_in_ip:
@@ -2783,8 +3161,8 @@ paths:
metadata: {}
last_sign_in_at:
current_sign_in_at:
- created_at: '2026-05-26T16:12:15.770Z'
- updated_at: '2026-05-26T16:12:15.770Z'
+ created_at: '2026-05-26T17:52:05.562Z'
+ updated_at: '2026-05-26T17:52:05.562Z'
sign_in_count: 0
failed_attempts: 0
last_sign_in_ip:
@@ -2858,8 +3236,8 @@ paths:
metadata: {}
last_sign_in_at:
current_sign_in_at:
- created_at: '2026-05-26T16:12:16.321Z'
- updated_at: '2026-05-26T16:12:16.603Z'
+ created_at: '2026-05-26T17:52:06.108Z'
+ updated_at: '2026-05-26T17:52:06.389Z'
sign_in_count: 0
failed_attempts: 0
last_sign_in_ip:
@@ -3289,11 +3667,11 @@ paths:
example:
data:
- id: exp_UkLWZg9DAJ
- number: EF917174541
+ number: EF167643602
type: Spree::Exports::Products
format: csv
- created_at: '2026-05-26T16:12:20.761Z'
- updated_at: '2026-05-26T16:12:20.761Z'
+ created_at: '2026-05-26T17:52:10.534Z'
+ updated_at: '2026-05-26T17:52:10.534Z'
user_id: admin_UkLWZg9DAJ
done: false
filename:
@@ -3360,11 +3738,11 @@ paths:
application/json:
example:
id: exp_gbHJdmfrXB
- number: EF717713311
+ number: EF290770828
type: Spree::Exports::Products
format: csv
- created_at: '2026-05-26T16:12:21.059Z'
- updated_at: '2026-05-26T16:12:21.059Z'
+ created_at: '2026-05-26T17:52:10.873Z'
+ updated_at: '2026-05-26T17:52:10.873Z'
user_id: admin_UkLWZg9DAJ
done: false
filename:
@@ -3451,11 +3829,11 @@ paths:
application/json:
example:
id: exp_UkLWZg9DAJ
- number: EF426554878
+ number: EF751026461
type: Spree::Exports::Products
format: csv
- created_at: '2026-05-26T16:12:21.330Z'
- updated_at: '2026-05-26T16:12:21.330Z'
+ created_at: '2026-05-26T17:52:11.155Z'
+ updated_at: '2026-05-26T17:52:11.155Z'
user_id: admin_UkLWZg9DAJ
done: false
filename:
@@ -3638,8 +4016,8 @@ paths:
codes_count: 2
currency: USD
prefix: WELCOME
- created_at: '2026-05-26T16:12:21.926Z'
- updated_at: '2026-05-26T16:12:21.926Z'
+ created_at: '2026-05-26T17:52:11.833Z'
+ updated_at: '2026-05-26T17:52:11.833Z'
amount: '50.0'
expires_at:
created_by_id:
@@ -3720,8 +4098,8 @@ paths:
codes_count: 5
currency: USD
prefix: NEWCAMP
- created_at: '2026-05-26T16:12:22.496Z'
- updated_at: '2026-05-26T16:12:22.496Z'
+ created_at: '2026-05-26T17:52:12.432Z'
+ updated_at: '2026-05-26T17:52:12.432Z'
amount: '25.0'
expires_at: '2030-12-31'
created_by_id: admin_UkLWZg9DAJ
@@ -3822,8 +4200,8 @@ paths:
codes_count: 2
currency: USD
prefix: WELCOME
- created_at: '2026-05-26T16:12:22.788Z'
- updated_at: '2026-05-26T16:12:22.788Z'
+ created_at: '2026-05-26T17:52:12.721Z'
+ updated_at: '2026-05-26T17:52:12.721Z'
amount: '50.0'
expires_at:
created_by_id:
@@ -3926,7 +4304,7 @@ paths:
example:
data:
- id: gc_UkLWZg9DAJ
- code: E9E1428FD796712F
+ code: '08D74FE0725882E2'
status: active
currency: USD
amount: '50.0'
@@ -3940,12 +4318,12 @@ paths:
redeemed_at:
expired: false
active: true
- created_at: '2026-05-26T16:12:23.364Z'
- updated_at: '2026-05-26T16:12:23.364Z'
+ created_at: '2026-05-26T17:52:13.292Z'
+ updated_at: '2026-05-26T17:52:13.292Z'
customer_id:
created_by_id:
- id: gc_gbHJdmfrXB
- code: D2F00134CB4D9913
+ code: CA2BF783B773A184
status: active
currency: USD
amount: '25.0'
@@ -3959,8 +4337,8 @@ paths:
redeemed_at:
expired: false
active: true
- created_at: '2026-05-26T16:12:23.365Z'
- updated_at: '2026-05-26T16:12:23.365Z'
+ created_at: '2026-05-26T17:52:13.293Z'
+ updated_at: '2026-05-26T17:52:13.293Z'
customer_id:
created_by_id:
meta:
@@ -4045,7 +4423,7 @@ paths:
application/json:
example:
id: gc_EfhxLZ9ck8
- code: 31F056B764C08321
+ code: E99564A686FDBCE8
status: active
currency: USD
amount: '25.0'
@@ -4059,8 +4437,8 @@ paths:
redeemed_at:
expired: false
active: true
- created_at: '2026-05-26T16:12:23.972Z'
- updated_at: '2026-05-26T16:12:23.972Z'
+ created_at: '2026-05-26T17:52:13.888Z'
+ updated_at: '2026-05-26T17:52:13.888Z'
customer_id:
created_by_id: admin_UkLWZg9DAJ
schema:
@@ -4166,7 +4544,7 @@ paths:
application/json:
example:
id: gc_UkLWZg9DAJ
- code: F15BC55E98D6DB74
+ code: E3DAB2A855A74970
status: active
currency: USD
amount: '50.0'
@@ -4180,8 +4558,8 @@ paths:
redeemed_at:
expired: false
active: true
- created_at: '2026-05-26T16:12:24.270Z'
- updated_at: '2026-05-26T16:12:24.270Z'
+ created_at: '2026-05-26T17:52:14.177Z'
+ updated_at: '2026-05-26T17:52:14.177Z'
customer_id:
created_by_id:
schema:
@@ -4241,7 +4619,7 @@ paths:
application/json:
example:
id: gc_UkLWZg9DAJ
- code: 32CC301C086F291F
+ code: BEBA650ACF719F03
status: active
currency: USD
amount: '75.0'
@@ -4255,8 +4633,8 @@ paths:
redeemed_at:
expired: false
active: true
- created_at: '2026-05-26T16:12:24.842Z'
- updated_at: '2026-05-26T16:12:25.123Z'
+ created_at: '2026-05-26T17:52:14.746Z'
+ updated_at: '2026-05-26T17:52:15.025Z'
customer_id:
created_by_id:
schema:
@@ -4368,15 +4746,15 @@ paths:
example:
data:
- id: inv_UkLWZg9DAJ
status: pending
- created_at: '2026-05-26T16:12:25.976Z'
- updated_at: '2026-05-26T16:12:25.976Z'
- expires_at: '2026-06-09T16:12:25.973Z'
+ created_at: '2026-05-26T17:52:15.884Z'
+ updated_at: '2026-05-26T17:52:15.884Z'
+ expires_at: '2026-06-09T17:52:15.881Z'
role_id: role_UkLWZg9DAJ
role_name: admin
- inviter_email: [email protected]
- acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=R2VpavHrbEcsj4MK8cEG7mNx"
+ inviter_email: [email protected]
+ acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=PYR7NdsSCUahFDBdGmPfwpHw"
invitee_exists: false
store:
id: store_UkLWZg9DAJ
@@ -4437,13 +4815,13 @@ paths:
id: inv_gbHJdmfrXB
status: pending
- created_at: '2026-05-26T16:12:26.278Z'
- updated_at: '2026-05-26T16:12:26.278Z'
- expires_at: '2026-06-09T16:12:26.275Z'
+ created_at: '2026-05-26T17:52:16.204Z'
+ updated_at: '2026-05-26T17:52:16.204Z'
+ expires_at: '2026-06-09T17:52:16.203Z'
role_id: role_UkLWZg9DAJ
role_name: admin
- inviter_email: [email protected]
- acceptance_url: "/accept-invitation/inv_gbHJdmfrXB?token=gcFU19NSNVETM6Jj1uSi69yh"
+ inviter_email: [email protected]
+ acceptance_url: "/accept-invitation/inv_gbHJdmfrXB?token=7cANRbWY9a76HUjctSh8UiRF"
invitee_exists: false
store:
id: store_UkLWZg9DAJ
@@ -4550,15 +4928,15 @@ paths:
application/json:
example:
id: inv_UkLWZg9DAJ
status: pending
- created_at: '2026-05-26T16:12:26.833Z'
- updated_at: '2026-05-26T16:12:26.833Z'
- expires_at: '2026-06-09T16:12:26.831Z'
+ created_at: '2026-05-26T17:52:16.760Z'
+ updated_at: '2026-05-26T17:52:16.760Z'
+ expires_at: '2026-06-09T17:52:16.758Z'
role_id: role_UkLWZg9DAJ
role_name: admin
- inviter_email: [email protected]
- acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=yRB6MxhKyVFRgWXWRXJmRXey"
+ inviter_email: [email protected]
+ acceptance_url: "/accept-invitation/inv_UkLWZg9DAJ?token=hBYpmynb5n9MwvGWDhgH783d"
invitee_exists: false
store:
id: store_UkLWZg9DAJ
@@ -4644,8 +5022,8 @@ paths:
- DE
supported_locales:
- en
- created_at: '2026-05-26T16:12:26.890Z'
- updated_at: '2026-05-26T16:12:26.890Z'
+ created_at: '2026-05-26T17:52:16.816Z'
+ updated_at: '2026-05-26T17:52:16.816Z'
meta:
page: 1
limit: 25
@@ -4735,8 +5113,8 @@ paths:
supported_locales:
- en
- fr
- created_at: '2026-05-26T16:12:27.501Z'
- updated_at: '2026-05-26T16:12:27.501Z'
+ created_at: '2026-05-26T17:52:17.417Z'
+ updated_at: '2026-05-26T17:52:17.417Z'
schema:
"$ref": "#/components/schemas/Market"
'422':
@@ -4869,8 +5247,8 @@ paths:
- DE
supported_locales:
- en
- created_at: '2026-05-26T16:12:27.829Z'
- updated_at: '2026-05-26T16:12:27.829Z'
+ created_at: '2026-05-26T17:52:17.747Z'
+ updated_at: '2026-05-26T17:52:17.747Z'
schema:
"$ref": "#/components/schemas/Market"
'404':
@@ -4946,8 +5324,8 @@ paths:
- DE
supported_locales:
- en
- created_at: '2026-05-26T16:12:28.435Z'
- updated_at: '2026-05-26T16:12:28.718Z'
+ created_at: '2026-05-26T17:52:18.383Z'
+ updated_at: '2026-05-26T17:52:18.695Z'
schema:
"$ref": "#/components/schemas/Market"
'422':
@@ -5084,12 +5462,12 @@ paths:
example:
user:
id: admin_UkLWZg9DAJ
- first_name: Cordell
- last_name: Schmitt
- full_name: Cordell Schmitt
- created_at: '2026-05-26T16:12:29.922Z'
- updated_at: '2026-05-26T16:12:29.922Z'
+ first_name: Tillie
+ last_name: Turcotte
+ full_name: Tillie Turcotte
+ created_at: '2026-05-26T17:52:19.889Z'
+ updated_at: '2026-05-26T17:52:19.889Z'
roles:
- id: role_UkLWZg9DAJ
name: admin
@@ -5239,8 +5617,8 @@ paths:
kind: dropdown
metadata: {}
filterable: true
- created_at: '2026-05-26T16:12:29.971Z'
- updated_at: '2026-05-26T16:12:29.971Z'
+ created_at: '2026-05-26T17:52:19.931Z'
+ updated_at: '2026-05-26T17:52:19.931Z'
meta:
page: 1
limit: 25
@@ -5331,8 +5709,8 @@ paths:
kind: dropdown
metadata: {}
filterable: true
- created_at: '2026-05-26T16:12:30.584Z'
- updated_at: '2026-05-26T16:12:30.584Z'
+ created_at: '2026-05-26T17:52:20.547Z'
+ updated_at: '2026-05-26T17:52:20.547Z'
schema:
"$ref": "#/components/schemas/OptionType"
'422':
@@ -5453,8 +5831,8 @@ paths:
kind: dropdown
metadata: {}
filterable: true
- created_at: '2026-05-26T16:12:30.884Z'
- updated_at: '2026-05-26T16:12:30.884Z'
+ created_at: '2026-05-26T17:52:20.835Z'
+ updated_at: '2026-05-26T17:52:20.835Z'
schema:
"$ref": "#/components/schemas/OptionType"
'404':
@@ -5526,8 +5904,8 @@ paths:
kind: dropdown
metadata: {}
filterable: true
- created_at: '2026-05-26T16:12:31.534Z'
- updated_at: '2026-05-26T16:12:31.813Z'
+ created_at: '2026-05-26T17:52:21.400Z'
+ updated_at: '2026-05-26T17:52:21.680Z'
schema:
"$ref": "#/components/schemas/OptionType"
'422':
@@ -5686,7 +6064,7 @@ paths:
example:
data:
- id: ful_UkLWZg9DAJ
- number: H21426817644
+ number: H29066075126
tracking: U10000
tracking_url:
cost: '10.0'
@@ -5711,8 +6089,8 @@ paths:
metadata: {}
adjustment_total: '0.0'
pre_tax_amount: '0.0'
- created_at: '2026-05-26T16:12:32.807Z'
- updated_at: '2026-05-26T16:12:32.886Z'
+ created_at: '2026-05-26T17:52:22.651Z'
+ updated_at: '2026-05-26T17:52:22.735Z'
order_id: or_UkLWZg9DAJ
stock_location_id: sloc_UkLWZg9DAJ
meta:
@@ -5795,7 +6173,7 @@ paths:
application/json:
example:
id: ful_UkLWZg9DAJ
- number: H02734152340
+ number: H98057773065
tracking: U10000
tracking_url:
cost: '10.0'
@@ -5820,8 +6198,8 @@ paths:
metadata: {}
adjustment_total: '0.0'
pre_tax_amount: '0.0'
- created_at: '2026-05-26T16:12:33.518Z'
- updated_at: '2026-05-26T16:12:33.582Z'
+ created_at: '2026-05-26T17:52:23.349Z'
+ updated_at: '2026-05-26T17:52:23.413Z'
order_id: or_UkLWZg9DAJ
stock_location_id: sloc_UkLWZg9DAJ
patch:
@@ -5880,7 +6258,7 @@ paths:
application/json:
example:
id: ful_UkLWZg9DAJ
- number: H27987471741
+ number: H92287134997
tracking: 1Z999AA10123456784
tracking_url: https://wwwapps.ups.com/WebTracking/track?track=yes&trackNums=1Z999AA10123456784
cost: '10.0'
@@ -5905,8 +6283,8 @@ paths:
metadata: {}
adjustment_total: '0.0'
pre_tax_amount: '0.0'
- created_at: '2026-05-26T16:12:34.190Z'
- updated_at: '2026-05-26T16:12:34.537Z'
+ created_at: '2026-05-26T17:52:24.009Z'
+ updated_at: '2026-05-26T17:52:24.375Z'
order_id: or_UkLWZg9DAJ
stock_location_id: sloc_UkLWZg9DAJ
requestBody:
@@ -5975,7 +6353,7 @@ paths:
application/json:
example:
id: ful_UkLWZg9DAJ
- number: H69306138629
+ number: H67767186834
tracking: U10000
tracking_url:
cost: '10.0'
@@ -5992,7 +6370,7 @@ paths:
display_tax_total: "$0.00"
status: shipped
fulfillment_type: shipping
- fulfilled_at: '2026-05-26T16:12:35Z'
+ fulfilled_at: '2026-05-26T17:52:25Z'
items:
- item_id: li_UkLWZg9DAJ
variant_id: variant_UkLWZg9DAJ
@@ -6000,8 +6378,8 @@ paths:
metadata: {}
adjustment_total: '0.0'
pre_tax_amount: '0.0'
- created_at: '2026-05-26T16:12:34.928Z'
- updated_at: '2026-05-26T16:12:35.370Z'
+ created_at: '2026-05-26T17:52:24.739Z'
+ updated_at: '2026-05-26T17:52:25.089Z'
order_id: or_UkLWZg9DAJ
stock_location_id: sloc_UkLWZg9DAJ
"/api/v3/admin/orders/{order_id}/fulfillments/{id}/cancel":
@@ -6059,7 +6437,7 @@ paths:
application/json:
example:
id: ful_UkLWZg9DAJ
- number: H79577206102
+ number: H11808684409
tracking: U10000
tracking_url:
cost: '10.0'
@@ -6084,8 +6462,8 @@ paths:
metadata: {}
adjustment_total: '0.0'
pre_tax_amount: '0.0'
- created_at: '2026-05-26T16:12:35.712Z'
- updated_at: '2026-05-26T16:12:36.066Z'
+ created_at: '2026-05-26T17:52:25.418Z'
+ updated_at: '2026-05-26T17:52:25.760Z'
order_id: or_UkLWZg9DAJ
stock_location_id: sloc_UkLWZg9DAJ
"/api/v3/admin/orders/{order_id}/fulfillments/{id}/resume":
@@ -6143,7 +6521,7 @@ paths:
application/json:
example:
id: ful_UkLWZg9DAJ
- number: H59689445550
+ number: H31829332563
tracking: U10000
tracking_url:
cost: '10.0'
@@ -6168,8 +6546,8 @@ paths:
metadata: {}
adjustment_total: '0.0'
pre_tax_amount: '0.0'
- created_at: '2026-05-26T16:12:36.394Z'
- updated_at: '2026-05-26T16:12:36.772Z'
+ created_at: '2026-05-26T17:52:26.105Z'
+ updated_at: '2026-05-26T17:52:26.468Z'
order_id: or_UkLWZg9DAJ
stock_location_id: sloc_UkLWZg9DAJ
"/api/v3/admin/orders/{order_id}/fulfillments/{id}/split":
@@ -6230,7 +6608,7 @@ paths:
example:
data:
- id: ful_gbHJdmfrXB
- number: H53323829337
+ number: H53634243998
tracking:
tracking_url:
cost: '10.0'
@@ -6255,8 +6633,8 @@ paths:
metadata: {}
adjustment_total: '0.0'
pre_tax_amount: '0.0'
- created_at: '2026-05-26T16:12:37.468Z'
- updated_at: '2026-05-26T16:12:37.514Z'
+ created_at: '2026-05-26T17:52:27.153Z'
+ updated_at: '2026-05-26T17:52:27.200Z'
order_id: or_UkLWZg9DAJ
stock_location_id: sloc_gbHJdmfrXB
requestBody:
@@ -6328,7 +6706,7 @@ paths:
application/json:
example:
id: gc_UkLWZg9DAJ
- code: 7C74EE58D26F1DA3
+ code: 035EC81510AA1800
status: active
currency: USD
amount: '10.0'
@@ -6342,8 +6720,8 @@ paths:
redeemed_at:
expired: false
active: true
- created_at: '2026-05-26T16:12:37.861Z'
- updated_at: '2026-05-26T16:12:38.166Z'
+ created_at: '2026-05-26T17:52:27.557Z'
+ updated_at: '2026-05-26T17:52:27.856Z'
customer_id:
created_by_id:
requestBody:
@@ -6476,8 +6854,8 @@ paths:
variant_id: variant_gbHJdmfrXB
quantity: 2
currency: USD
- name: Product 106736
- slug: product-106736
+ name: Product 109017
+ slug: product-109017
options_text: 'Size: S'
price: '10.0'
display_price: "$10.00"
@@ -6509,12 +6887,12 @@ paths:
option_type_label: Size
image_url:
metadata: {}
- created_at: '2026-05-26T16:12:38.865Z'
- updated_at: '2026-05-26T16:12:38.865Z'
+ created_at: '2026-05-26T17:52:28.552Z'
+ updated_at: '2026-05-26T17:52:28.552Z'
digital_links: []
metadata: {}
- created_at: '2026-05-26T16:12:39.158Z'
- updated_at: '2026-05-26T16:12:39.158Z'
+ created_at: '2026-05-26T17:52:28.869Z'
+ updated_at: '2026-05-26T17:52:28.869Z'
cost_price: '17.0'
tax_category_id: taxcat_UkLWZg9DAJ
meta:
@@ -6581,8 +6959,8 @@ paths:
variant_id: variant_VqXmZF31wY
quantity: 3
currency: USD
- name: Product 126379
- slug: product-126379
+ name: Product 124630
+ slug: product-124630
options_text: 'Size: S'
price: '19.99'
display_price: "$19.99"
@@ -6614,12 +6992,12 @@ paths:
option_type_label: Size
image_url:
metadata: {}
- created_at: '2026-05-26T16:12:40.169Z'
- updated_at: '2026-05-26T16:12:40.169Z'
+ created_at: '2026-05-26T17:52:29.821Z'
+ updated_at: '2026-05-26T17:52:29.821Z'
digital_links: []
metadata: {}
- created_at: '2026-05-26T16:12:40.233Z'
- updated_at: '2026-05-26T16:12:40.233Z'
+ created_at: '2026-05-26T17:52:29.857Z'
+ updated_at: '2026-05-26T17:52:29.857Z'
cost_price: '17.0'
tax_category_id: taxcat_UkLWZg9DAJ
requestBody:
@@ -6708,8 +7086,8 @@ paths:
variant_id: variant_gbHJdmfrXB
quantity: 2
currency: USD
- name: Product 132960
- slug: product-132960
+ name: Product 134662
+ slug: product-134662
options_text: 'Size: S'
price: '10.0'
display_price: "$10.00"
@@ -6741,12 +7119,12 @@ paths:
option_type_label: Size
image_url:
metadata: {}
- created_at: '2026-05-26T16:12:40.319Z'
- updated_at: '2026-05-26T16:12:40.319Z'
+ created_at: '2026-05-26T17:52:29.934Z'
+ updated_at: '2026-05-26T17:52:29.934Z'
digital_links: []
metadata: {}
- created_at: '2026-05-26T16:12:40.672Z'
- updated_at: '2026-05-26T16:12:40.672Z'
+ created_at: '2026-05-26T17:52:30.223Z'
+ updated_at: '2026-05-26T17:52:30.223Z'
cost_price: '17.0'
tax_category_id: taxcat_UkLWZg9DAJ
patch:
@@ -6808,8 +7186,8 @@ paths:
variant_id: variant_gbHJdmfrXB
quantity: 5
currency: USD
- name: Product 142304
- slug: product-142304
+ name: Product 145786
+ slug: product-145786
options_text: 'Size: S'
price: '19.99'
display_price: "$19.99"
@@ -6841,12 +7219,12 @@ paths:
option_type_label: Size
image_url:
metadata: {}
- created_at: '2026-05-26T16:12:41.005Z'
- updated_at: '2026-05-26T16:12:41.005Z'
+ created_at: '2026-05-26T17:52:30.554Z'
+ updated_at: '2026-05-26T17:52:30.554Z'
digital_links: []
metadata: {}
- created_at: '2026-05-26T16:12:41.293Z'
- updated_at: '2026-05-26T16:12:41.588Z'
+ created_at: '2026-05-26T17:52:30.863Z'
+ updated_at: '2026-05-26T17:52:31.194Z'
cost_price: '17.0'
tax_category_id: taxcat_UkLWZg9DAJ
requestBody:
@@ -6972,8 +7350,8 @@ paths:
data:
- id: py_UkLWZg9DAJ
payment_method_id: pm_UkLWZg9DAJ
- response_code: BGS-fb554349125f
- number: P1B8HOBK
+ response_code: BGS-442aff7e66b9
+ number: P29L2XMA
amount: '110.0'
display_amount: "$110.00"
status: completed
@@ -6991,14 +7369,14 @@ paths:
customer_id:
payment_method_id: pm_gbHJdmfrXB
metadata: {}
- created_at: '2026-05-26T16:12:42.609Z'
- updated_at: '2026-05-26T16:12:42.611Z'
+ created_at: '2026-05-26T17:52:32.258Z'
+ updated_at: '2026-05-26T17:52:32.261Z'
metadata: {}
avs_response:
cvv_response_code:
cvv_response_message:
- created_at: '2026-05-26T16:12:42.610Z'
- updated_at: '2026-05-26T16:12:42.610Z'
+ created_at: '2026-05-26T17:52:32.260Z'
+ updated_at: '2026-05-26T17:52:32.260Z'
captured_amount: '0.0'
order_id: or_UkLWZg9DAJ
meta:
@@ -7065,7 +7443,7 @@ paths:
id: py_gbHJdmfrXB
payment_method_id: pm_EfhxLZ9ck8
response_code:
- number: PYKPEF6D
+ number: PL12OKX2
amount: '110.0'
display_amount: "$110.00"
status: checkout
@@ -7076,8 +7454,8 @@ paths:
avs_response:
cvv_response_code:
cvv_response_message:
- created_at: '2026-05-26T16:12:44.021Z'
- updated_at: '2026-05-26T16:12:44.021Z'
+ created_at: '2026-05-26T17:52:33.625Z'
+ updated_at: '2026-05-26T17:52:33.625Z'
captured_amount: '0.0'
order_id: or_gbHJdmfrXB
requestBody:
@@ -7167,8 +7545,8 @@ paths:
example:
id: py_UkLWZg9DAJ
payment_method_id: pm_UkLWZg9DAJ
- response_code: BGS-cb0e28824009
- number: P5L7QR1T
+ response_code: BGS-a6a3f6ce3e94
+ number: PPQVSKFL
amount: '110.0'
display_amount: "$110.00"
status: completed
@@ -7186,14 +7564,14 @@ paths:
customer_id:
payment_method_id: pm_gbHJdmfrXB
metadata: {}
- created_at: '2026-05-26T16:12:44.393Z'
- updated_at: '2026-05-26T16:12:44.396Z'
+ created_at: '2026-05-26T17:52:34.013Z'
+ updated_at: '2026-05-26T17:52:34.016Z'
metadata: {}
avs_response:
cvv_response_code:
cvv_response_message:
- created_at: '2026-05-26T16:12:44.395Z'
- updated_at: '2026-05-26T16:12:44.395Z'
+ created_at: '2026-05-26T17:52:34.015Z'
+ updated_at: '2026-05-26T17:52:34.015Z'
captured_amount: '0.0'
order_id: or_UkLWZg9DAJ
"/api/v3/admin/orders/{order_id}/payments/{id}/capture":
@@ -7252,8 +7630,8 @@ paths:
example:
id: py_UkLWZg9DAJ
payment_method_id: pm_UkLWZg9DAJ
- response_code: BGS-bce1b7b66ee7
- number: P5QPPK46
+ response_code: BGS-066bbc5c8edf
+ number: P3YR89ZJ
amount: '110.0'
display_amount: "$110.00"
status: completed
@@ -7271,14 +7649,14 @@ paths:
customer_id:
payment_method_id: pm_gbHJdmfrXB
metadata: {}
- created_at: '2026-05-26T16:12:45.123Z'
- updated_at: '2026-05-26T16:12:45.126Z'
+ created_at: '2026-05-26T17:52:34.691Z'
+ updated_at: '2026-05-26T17:52:34.694Z'
metadata: {}
avs_response:
cvv_response_code:
cvv_response_message:
- created_at: '2026-05-26T16:12:45.125Z'
- updated_at: '2026-05-26T16:12:45.459Z'
+ created_at: '2026-05-26T17:52:34.693Z'
+ updated_at: '2026-05-26T17:52:35.023Z'
captured_amount: '110.0'
order_id: or_UkLWZg9DAJ
'422':
@@ -7347,8 +7725,8 @@ paths:
example:
id: py_UkLWZg9DAJ
payment_method_id: pm_UkLWZg9DAJ
- response_code: void-BGS-2cd9f486d559
- number: PN45KFXM
+ response_code: void-BGS-f223de63721d
+ number: PGV0QYB2
amount: '110.0'
display_amount: "$110.00"
status: void
@@ -7366,14 +7744,14 @@ paths:
customer_id:
payment_method_id: pm_gbHJdmfrXB
metadata: {}
- created_at: '2026-05-26T16:12:46.548Z'
- updated_at: '2026-05-26T16:12:46.550Z'
+ created_at: '2026-05-26T17:52:36.149Z'
+ updated_at: '2026-05-26T17:52:36.151Z'
metadata: {}
avs_response:
cvv_response_code:
cvv_response_message:
- created_at: '2026-05-26T16:12:46.549Z'
- updated_at: '2026-05-26T16:12:46.857Z'
+ created_at: '2026-05-26T17:52:36.150Z'
+ updated_at: '2026-05-26T17:52:36.453Z'
captured_amount: '0.0'
order_id: or_UkLWZg9DAJ
"/api/v3/admin/orders/{order_id}/refunds":
@@ -7501,14 +7879,14 @@ paths:
application/json:
example:
id: re_UkLWZg9DAJ
- transaction_id: BGS-47496253cbfc
+ transaction_id: BGS-c1dd3d16a728
amount: '5.0'
payment_id: py_UkLWZg9DAJ
refund_reason_id: rr_UkLWZg9DAJ
reimbursement_id:
metadata: {}
- created_at: '2026-05-26T16:12:48.332Z'
- updated_at: '2026-05-26T16:12:48.332Z'
+ created_at: '2026-05-26T17:52:37.877Z'
+ updated_at: '2026-05-26T17:52:37.877Z'
requestBody:
content:
application/json:
@@ -7580,8 +7958,8 @@ paths:
id: or_UkLWZg9DAJ
market_id:
channel_id: ch_UkLWZg9DAJ
- number: R261232121
+ number: R279848324
customer_note:
currency: USD
locale: en
@@ -7624,8 +8002,8 @@ paths:
metadata: {}
canceled_at:
approved_at:
- created_at: '2026-05-26T16:12:48.631Z'
- updated_at: '2026-05-26T16:12:48.679Z'
+ created_at: '2026-05-26T17:52:38.179Z'
+ updated_at: '2026-05-26T17:52:38.236Z'
preferred_stock_location_id:
tags: []
internal_note:
@@ -7796,8 +8174,8 @@ paths:
- id: or_UkLWZg9DAJ
market_id:
channel_id: ch_UkLWZg9DAJ
- number: R429606837
+ number: R621043079
customer_note:
currency: USD
locale: en
@@ -7840,8 +8218,8 @@ paths:
metadata: {}
canceled_at:
approved_at:
- created_at: '2026-05-26T16:12:50.490Z'
- updated_at: '2026-05-26T16:12:50.490Z'
+ created_at: '2026-05-26T17:52:40.015Z'
+ updated_at: '2026-05-26T17:52:40.015Z'
preferred_stock_location_id:
tags: []
internal_note:
@@ -7984,7 +8362,7 @@ paths:
id: or_gbHJdmfrXB
market_id:
channel_id: ch_UkLWZg9DAJ
- number: R970412419
+ number: R707010461
customer_note:
currency: USD
@@ -8028,8 +8406,8 @@ paths:
metadata: {}
canceled_at:
approved_at:
- created_at: '2026-05-26T16:12:52.257Z'
- updated_at: '2026-05-26T16:12:52.260Z'
+ created_at: '2026-05-26T17:52:41.708Z'
+ updated_at: '2026-05-26T17:52:41.717Z'
preferred_stock_location_id: sloc_UkLWZg9DAJ
tags: []
internal_note:
@@ -8213,8 +8591,8 @@ paths:
id: or_UkLWZg9DAJ
market_id:
channel_id: ch_UkLWZg9DAJ
- number: R192431263
+ number: R186378802
customer_note:
currency: USD
locale: en
@@ -8257,8 +8635,8 @@ paths:
metadata: {}
canceled_at:
approved_at:
- created_at: '2026-05-26T16:12:52.542Z'
- updated_at: '2026-05-26T16:12:52.542Z'
+ created_at: '2026-05-26T17:52:42.023Z'
+ updated_at: '2026-05-26T17:52:42.023Z'
preferred_stock_location_id:
tags: []
internal_note:
@@ -8329,7 +8707,7 @@ paths:
id: or_UkLWZg9DAJ
market_id:
channel_id: ch_UkLWZg9DAJ
- number: R080725845
+ number: R038382939
customer_note:
currency: USD
@@ -8373,8 +8751,8 @@ paths:
metadata: {}
canceled_at:
approved_at:
- created_at: '2026-05-26T16:12:53.885Z'
- updated_at: '2026-05-26T16:12:54.237Z'
+ created_at: '2026-05-26T17:52:43.130Z'
+ updated_at: '2026-05-26T17:52:43.419Z'
preferred_stock_location_id:
tags: []
internal_note:
@@ -8555,8 +8933,8 @@ paths:
id: or_UkLWZg9DAJ
market_id:
channel_id: ch_UkLWZg9DAJ
- number: R195995246
+ number: R172519829
customer_note:
currency: USD
locale: en
@@ -8583,7 +8961,7 @@ paths:
display_delivery_total: "$100.00"
fulfillment_status: ready
payment_status: paid
- completed_at: '2026-05-26T16:12:55.560Z'
+ completed_at: '2026-05-26T17:52:44.341Z'
store_credit_total: '0.0'
display_store_credit_total: "$0.00"
covered_by_store_credit: false
@@ -8599,8 +8977,8 @@ paths:
metadata: {}
canceled_at:
approved_at:
- created_at: '2026-05-26T16:12:55.464Z'
- updated_at: '2026-05-26T16:12:55.607Z'
+ created_at: '2026-05-26T17:52:44.281Z'
+ updated_at: '2026-05-26T17:52:44.369Z'
preferred_stock_location_id:
tags: []
internal_note:
@@ -8681,8 +9059,8 @@ paths:
id: or_UkLWZg9DAJ
market_id:
channel_id: ch_UkLWZg9DAJ
- number: R675496720
+ number: R489669586
customer_note:
currency: USD
locale: en
@@ -8709,7 +9087,7 @@ paths:
display_delivery_total: "$10.00"
fulfillment_status: canceled
payment_status: void
- completed_at: '2026-05-26T16:12:57.041Z'
+ completed_at: '2026-05-26T17:52:45.690Z'
store_credit_total: '0.0'
display_store_credit_total: "$0.00"
covered_by_store_credit: false
@@ -8723,10 +9101,10 @@ paths:
payment_total: '0.0'
display_payment_total: "$0.00"
metadata: {}
- canceled_at: '2026-05-26T16:12:57.344Z'
+ canceled_at: '2026-05-26T17:52:46.000Z'
approved_at:
- created_at: '2026-05-26T16:12:56.979Z'
- updated_at: '2026-05-26T16:12:57.419Z'
+ created_at: '2026-05-26T17:52:45.591Z'
+ updated_at: '2026-05-26T17:52:46.078Z'
preferred_stock_location_id:
tags: []
internal_note:
@@ -8785,8 +9163,8 @@ paths:
id: or_UkLWZg9DAJ
market_id:
channel_id: ch_UkLWZg9DAJ
- number: R677992716
+ number: R236286287
customer_note:
currency: USD
locale: en
@@ -8813,7 +9191,7 @@ paths:
display_delivery_total: "$100.00"
fulfillment_status:
payment_status:
- completed_at: '2026-05-26T16:12:57.795Z'
+ completed_at: '2026-05-26T17:52:46.437Z'
store_credit_total: '0.0'
display_store_credit_total: "$0.00"
covered_by_store_credit: false
@@ -8828,9 +9206,9 @@ paths:
display_payment_total: "$0.00"
metadata: {}
canceled_at:
- approved_at: '2026-05-26T16:12:58.093Z'
- created_at: '2026-05-26T16:12:57.737Z'
- updated_at: '2026-05-26T16:12:57.795Z'
+ approved_at: '2026-05-26T17:52:46.727Z'
+ created_at: '2026-05-26T17:52:46.380Z'
+ updated_at: '2026-05-26T17:52:46.437Z'
preferred_stock_location_id:
tags: []
internal_note:
@@ -8889,8 +9267,8 @@ paths:
id: or_UkLWZg9DAJ
market_id:
channel_id: ch_UkLWZg9DAJ
- number: R763215454
+ number: R657404315
customer_note:
currency: USD
locale: en
@@ -8917,7 +9295,7 @@ paths:
display_delivery_total: "$10.00"
fulfillment_status: canceled
payment_status: void
- completed_at: '2026-05-26T16:12:58.511Z'
+ completed_at: '2026-05-26T17:52:47.066Z'
store_credit_total: '0.0'
display_store_credit_total: "$0.00"
covered_by_store_credit: false
@@ -8931,10 +9309,10 @@ paths:
payment_total: '0.0'
display_payment_total: "$0.00"
metadata: {}
- canceled_at: '2026-05-26T16:12:58.808Z'
+ canceled_at: '2026-05-26T17:52:47.345Z'
approved_at:
- created_at: '2026-05-26T16:12:58.441Z'
- updated_at: '2026-05-26T16:12:58.901Z'
+ created_at: '2026-05-26T17:52:47.010Z'
+ updated_at: '2026-05-26T17:52:47.434Z'
preferred_stock_location_id:
tags: []
internal_note:
@@ -8993,8 +9371,8 @@ paths:
id: or_UkLWZg9DAJ
market_id:
channel_id: ch_UkLWZg9DAJ
- number: R416458573
+ number: R056496058
customer_note:
currency: USD
locale: en
@@ -9021,7 +9399,7 @@ paths:
display_delivery_total: "$100.00"
fulfillment_status:
payment_status:
- completed_at: '2026-05-26T16:12:59.293Z'
+ completed_at: '2026-05-26T17:52:47.788Z'
store_credit_total: '0.0'
display_store_credit_total: "$0.00"
covered_by_store_credit: false
@@ -9037,8 +9415,8 @@ paths:
metadata: {}
canceled_at:
approved_at:
- created_at: '2026-05-26T16:12:59.204Z'
- updated_at: '2026-05-26T16:12:59.293Z'
+ created_at: '2026-05-26T17:52:47.727Z'
+ updated_at: '2026-05-26T17:52:47.788Z'
preferred_stock_location_id:
tags: []
internal_note:
@@ -9113,8 +9491,8 @@ paths:
auto_capture:
storefront_visible: true
position: 1
- created_at: '2026-05-26T16:12:59.601Z'
- updated_at: '2026-05-26T16:12:59.602Z'
+ created_at: '2026-05-26T17:52:48.092Z'
+ updated_at: '2026-05-26T17:52:48.094Z'
preferences: {}
preference_schema: []
meta:
@@ -9254,8 +9632,8 @@ paths:
auto_capture:
storefront_visible: true
position: 1
- created_at: '2026-05-26T16:13:00.235Z'
- updated_at: '2026-05-26T16:13:00.237Z'
+ created_at: '2026-05-26T17:52:48.672Z'
+ updated_at: '2026-05-26T17:52:48.673Z'
preferences: {}
preference_schema: []
"/api/v3/admin/price_lists":
@@ -9328,8 +9706,8 @@ paths:
starts_at:
ends_at:
deleted_at:
- created_at: '2026-05-26T16:13:00.549Z'
- updated_at: '2026-05-26T16:13:00.549Z'
+ created_at: '2026-05-26T17:52:48.955Z'
+ updated_at: '2026-05-26T17:52:48.955Z'
currently_active: false
products_count: 0
prices_count: 0
@@ -9343,8 +9721,8 @@ paths:
starts_at:
ends_at:
deleted_at:
- created_at: '2026-05-26T16:13:00.551Z'
- updated_at: '2026-05-26T16:13:00.551Z'
+ created_at: '2026-05-26T17:52:48.956Z'
+ updated_at: '2026-05-26T17:52:48.956Z'
currently_active: false
products_count: 0
prices_count: 0
@@ -9408,8 +9786,8 @@ paths:
starts_at:
ends_at:
deleted_at:
- created_at: '2026-05-26T16:13:01.662Z'
- updated_at: '2026-05-26T16:13:01.664Z'
+ created_at: '2026-05-26T17:52:49.930Z'
+ updated_at: '2026-05-26T17:52:49.933Z'
currently_active: false
products_count: 1
prices_count: 2
@@ -9557,8 +9935,8 @@ paths:
starts_at:
ends_at:
deleted_at:
- created_at: '2026-05-26T16:13:02.010Z'
- updated_at: '2026-05-26T16:13:02.010Z'
+ created_at: '2026-05-26T17:52:50.226Z'
+ updated_at: '2026-05-26T17:52:50.226Z'
currently_active: false
products_count: 0
prices_count: 0
@@ -9616,8 +9994,8 @@ paths:
starts_at:
ends_at:
deleted_at:
- created_at: '2026-05-26T16:13:03.739Z'
- updated_at: '2026-05-26T16:13:04.021Z'
+ created_at: '2026-05-26T17:52:51.836Z'
+ updated_at: '2026-05-26T17:52:52.119Z'
currently_active: false
products_count: 0
prices_count: 0
@@ -9775,8 +10153,8 @@ paths:
starts_at:
ends_at:
deleted_at:
- created_at: '2026-05-26T16:13:04.320Z'
- updated_at: '2026-05-26T16:13:04.604Z'
+ created_at: '2026-05-26T17:52:52.414Z'
+ updated_at: '2026-05-26T17:52:52.693Z'
currently_active: true
products_count: 0
prices_count: 0
@@ -9824,8 +10202,8 @@ paths:
starts_at:
ends_at:
deleted_at:
- created_at: '2026-05-26T16:13:04.612Z'
- updated_at: '2026-05-26T16:13:04.892Z'
+ created_at: '2026-05-26T17:52:52.700Z'
+ updated_at: '2026-05-26T17:52:52.977Z'
currently_active: false
products_count: 0
prices_count: 0
@@ -9936,8 +10314,8 @@ paths:
display_compare_at_amount:
price_list_id:
variant_id: variant_gbHJdmfrXB
- created_at: '2026-05-26T16:13:04.948Z'
- updated_at: '2026-05-26T16:13:04.948Z'
+ created_at: '2026-05-26T17:52:53.044Z'
+ updated_at: '2026-05-26T17:52:53.044Z'
- id: price_EfhxLZ9ck8
amount: '5.0'
amount_in_cents: 500
@@ -9948,8 +10326,8 @@ paths:
display_compare_at_amount:
price_list_id: pl_UkLWZg9DAJ
variant_id: variant_gbHJdmfrXB
- created_at: '2026-05-26T16:13:04.955Z'
- updated_at: '2026-05-26T16:13:04.955Z'
+ created_at: '2026-05-26T17:52:53.051Z'
+ updated_at: '2026-05-26T17:52:53.051Z'
meta:
page: 1
limit: 25
@@ -10028,8 +10406,8 @@ paths:
display_compare_at_amount:
price_list_id:
variant_id: variant_EfhxLZ9ck8
- created_at: '2026-05-26T16:13:05.688Z'
- updated_at: '2026-05-26T16:13:05.688Z'
+ created_at: '2026-05-26T17:52:53.712Z'
+ updated_at: '2026-05-26T17:52:53.712Z'
schema:
"$ref": "#/components/schemas/Price"
requestBody:
@@ -10113,8 +10491,8 @@ paths:
display_compare_at_amount:
price_list_id: pl_UkLWZg9DAJ
variant_id: variant_gbHJdmfrXB
- created_at: '2026-05-26T16:13:05.792Z'
- updated_at: '2026-05-26T16:13:05.792Z'
+ created_at: '2026-05-26T17:52:53.778Z'
+ updated_at: '2026-05-26T17:52:53.778Z'
schema:
"$ref": "#/components/schemas/Price"
'404':
@@ -10176,8 +10554,8 @@ paths:
display_compare_at_amount:
price_list_id: pl_UkLWZg9DAJ
variant_id: variant_gbHJdmfrXB
- created_at: '2026-05-26T16:13:06.598Z'
- updated_at: '2026-05-26T16:13:06.880Z'
+ created_at: '2026-05-26T17:52:54.557Z'
+ updated_at: '2026-05-26T17:52:54.866Z'
schema:
"$ref": "#/components/schemas/Price"
requestBody:
@@ -10477,8 +10855,8 @@ paths:
field_type: short_text
key: custom.title
value: wool
- created_at: '2026-05-26T16:13:08.426Z'
- updated_at: '2026-05-26T16:13:08.426Z'
+ created_at: '2026-05-26T17:52:56.310Z'
+ updated_at: '2026-05-26T17:52:56.310Z'
storefront_visible: true
custom_field_definition_id: cfdef_UkLWZg9DAJ
meta:
@@ -10545,8 +10923,8 @@ paths:
field_type: long_text
key: custom.description
value: A longer description
- created_at: '2026-05-26T16:13:09.086Z'
- updated_at: '2026-05-26T16:13:09.086Z'
+ created_at: '2026-05-26T17:52:56.925Z'
+ updated_at: '2026-05-26T17:52:56.925Z'
storefront_visible: true
custom_field_definition_id: cfdef_gbHJdmfrXB
'422':
@@ -10630,8 +11008,8 @@ paths:
field_type: short_text
key: custom.title
value: wool
- created_at: '2026-05-26T16:13:09.478Z'
- updated_at: '2026-05-26T16:13:09.478Z'
+ created_at: '2026-05-26T17:52:57.283Z'
+ updated_at: '2026-05-26T17:52:57.283Z'
storefront_visible: true
custom_field_definition_id: cfdef_UkLWZg9DAJ
patch:
@@ -10678,8 +11056,8 @@ paths:
field_type: short_text
key: custom.title
value: cotton
- created_at: '2026-05-26T16:13:09.877Z'
- updated_at: '2026-05-26T16:13:10.226Z'
+ created_at: '2026-05-26T17:52:57.594Z'
+ updated_at: '2026-05-26T17:52:57.875Z'
storefront_visible: true
custom_field_definition_id: cfdef_UkLWZg9DAJ
requestBody:
@@ -10817,33 +11195,23 @@ paths:
example:
data:
- id: prod_UkLWZg9DAJ
- name: Product 551779
- slug: product-551779
+ name: Product 554100
+ slug: product-554100
meta_title:
meta_description:
meta_keywords:
variant_count: 0
- available_on: '2025-05-26T16:13:10.601Z'
+ available_on: '2025-05-26T17:52:58.200Z'
purchasable: true
in_stock: false
backorderable: true
available: true
- description: Doloribus sed culpa exercitationem harum explicabo.
- Esse minus repudiandae dicta commodi tenetur possimus. Ut illum
- officia sequi non aliquam. Laboriosam rem error debitis impedit
- dolorum mollitia. Vel eos ducimus nemo sed repellat quae ex. Libero
- quae voluptas voluptatibus occaecati quo minima natus esse. Nihil
- facilis autem suscipit pariatur. Exercitationem nostrum sint distinctio
- minima. Sit eveniet voluptate impedit adipisci eum. In maxime
- iure veniam laudantium hic repellendus at sed. Et magni veniam
- ea molestiae reprehenderit hic eius ex. Sed at soluta iusto vitae
- impedit modi atque. Facere quia iure eligendi deleniti optio.
- Dolorem occaecati fuga omnis officiis deleniti.
- description_html: |-
- Doloribus sed culpa exercitationem harum explicabo. Esse minus repudiandae dicta commodi tenetur possimus. Ut illum officia sequi non aliquam.
- Laboriosam rem error debitis impedit dolorum mollitia. Vel eos ducimus nemo sed repellat quae ex. Libero quae voluptas voluptatibus occaecati quo minima natus esse. Nihil facilis autem suscipit pariatur. Exercitationem nostrum sint distinctio minima.
- Sit eveniet voluptate impedit adipisci eum. In maxime iure veniam laudantium hic repellendus at sed. Et magni veniam ea molestiae reprehenderit hic eius ex.
- Sed at soluta iusto vitae impedit modi atque. Facere quia iure eligendi deleniti optio. Dolorem occaecati fuga omnis officiis deleniti.
+ description: Aspernatur ducimus commodi reprehenderit repellendus.
+ Necessitatibus dolorum ullam fugit animi rem commodi assumenda
+ quisquam. Omnis fugit ipsam voluptatem ut.
+ description_html: Aspernatur ducimus commodi reprehenderit repellendus.
+ Necessitatibus dolorum ullam fugit animi rem commodi assumenda
+ quisquam. Omnis fugit ipsam voluptatem ut.
default_variant_id: variant_UkLWZg9DAJ
thumbnail_url:
tags: []
@@ -10858,16 +11226,16 @@ paths:
display_compare_at_amount:
price_list_id:
variant_id: variant_UkLWZg9DAJ
- created_at: '2026-05-26T16:13:10.629Z'
- updated_at: '2026-05-26T16:13:10.629Z'
+ created_at: '2026-05-26T17:52:58.228Z'
+ updated_at: '2026-05-26T17:52:58.228Z'
original_price:
status: active
- make_active_at: '2025-05-26T16:13:10.601Z'
+ make_active_at: '2025-05-26T17:52:58.200Z'
discontinue_on:
metadata: {}
deleted_at:
- created_at: '2026-05-26T16:13:10.615Z'
- updated_at: '2026-05-26T16:13:10.630Z'
+ created_at: '2026-05-26T17:52:58.215Z'
+ updated_at: '2026-05-26T17:52:58.229Z'
tax_category_id: taxcat_UkLWZg9DAJ
meta:
page: 1
@@ -11001,8 +11369,8 @@ paths:
discontinue_on:
metadata: {}
deleted_at:
- created_at: '2026-05-26T16:13:11.307Z'
- updated_at: '2026-05-26T16:13:11.309Z'
+ created_at: '2026-05-26T17:52:58.904Z'
+ updated_at: '2026-05-26T17:52:58.906Z'
tax_category_id:
schema:
"$ref": "#/components/schemas/Product"
@@ -11182,35 +11550,25 @@ paths:
application/json:
example:
id: prod_UkLWZg9DAJ
- name: Product 591287
- slug: product-591287
+ name: Product 599627
+ slug: product-599627
meta_title:
meta_description:
meta_keywords:
variant_count: 0
- available_on: '2025-05-26T16:13:11.678Z'
+ available_on: '2025-05-26T17:52:59.279Z'
purchasable: true
in_stock: false
backorderable: true
available: true
- description: Ab vero perspiciatis repellat rem aspernatur minus. Recusandae
- suscipit facilis culpa sunt inventore. Nemo soluta at qui eligendi
- eveniet cumque consectetur. Omnis iure labore asperiores illo optio
- consequatur. Sint fugit nulla atque inventore illo exercitationem.
- Rem magnam iure porro quisquam. Laboriosam magnam vero possimus
- incidunt harum. Aut harum doloribus alias nam eligendi numquam ducimus.
- Ad sapiente magnam id illo consequuntur quod consectetur. Nesciunt
- nemo commodi laborum corrupti architecto voluptatum eveniet. Libero
- possimus optio totam cumque quasi iusto inventore. Ea amet quos
- explicabo corporis. Unde deserunt rerum minima blanditiis repudiandae
- tenetur amet. Atque reprehenderit recusandae cupiditate quis modi
- error laboriosam repudiandae. Recusandae modi ipsam suscipit autem
- perferendis eum error illum.
- description_html: |-
- Ab vero perspiciatis repellat rem aspernatur minus. Recusandae suscipit facilis culpa sunt inventore. Nemo soluta at qui eligendi eveniet cumque consectetur.
- Omnis iure labore asperiores illo optio consequatur. Sint fugit nulla atque inventore illo exercitationem. Rem magnam iure porro quisquam. Laboriosam magnam vero possimus incidunt harum. Aut harum doloribus alias nam eligendi numquam ducimus.
- Ad sapiente magnam id illo consequuntur quod consectetur. Nesciunt nemo commodi laborum corrupti architecto voluptatum eveniet. Libero possimus optio totam cumque quasi iusto inventore.
- Ea amet quos explicabo corporis. Unde deserunt rerum minima blanditiis repudiandae tenetur amet. Atque reprehenderit recusandae cupiditate quis modi error laboriosam repudiandae. Recusandae modi ipsam suscipit autem perferendis eum error illum.
+ description: Autem ab doloremque esse voluptates dolore recusandae
+ adipisci repudiandae. Eos unde cumque excepturi voluptatibus consectetur.
+ Temporibus omnis unde distinctio dignissimos eveniet reiciendis.
+ Animi corrupti quidem qui assumenda.
+ description_html: Autem ab doloremque esse voluptates dolore recusandae
+ adipisci repudiandae. Eos unde cumque excepturi voluptatibus consectetur.
+ Temporibus omnis unde distinctio dignissimos eveniet reiciendis.
+ Animi corrupti quidem qui assumenda.
default_variant_id: variant_UkLWZg9DAJ
thumbnail_url:
tags: []
@@ -11225,16 +11583,16 @@ paths:
display_compare_at_amount:
price_list_id:
variant_id: variant_UkLWZg9DAJ
- created_at: '2026-05-26T16:13:11.709Z'
- updated_at: '2026-05-26T16:13:11.709Z'
+ created_at: '2026-05-26T17:52:59.307Z'
+ updated_at: '2026-05-26T17:52:59.307Z'
original_price:
status: active
- make_active_at: '2025-05-26T16:13:11.678Z'
+ make_active_at: '2025-05-26T17:52:59.279Z'
discontinue_on:
metadata: {}
deleted_at:
- created_at: '2026-05-26T16:13:11.693Z'
- updated_at: '2026-05-26T16:13:11.710Z'
+ created_at: '2026-05-26T17:52:59.291Z'
+ updated_at: '2026-05-26T17:52:59.308Z'
tax_category_id: taxcat_UkLWZg9DAJ
schema:
"$ref": "#/components/schemas/Product"
@@ -11301,22 +11659,36 @@ paths:
example:
id: prod_UkLWZg9DAJ
name: Updated Name
- slug: product-619152
+ slug: product-61404
meta_title:
meta_description:
meta_keywords:
variant_count: 0
- available_on: '2025-05-26T16:13:12.328Z'
+ available_on: '2025-05-26T17:52:59.925Z'
purchasable: true
in_stock: false
backorderable: true
available: true
- description: Veritatis quibusdam quisquam nisi doloremque asperiores.
- Corrupti dolorem sequi odit cumque vero totam. Architecto exercitationem
- minus nemo blanditiis iure numquam eaque.
- description_html: Veritatis quibusdam quisquam nisi doloremque asperiores.
- Corrupti dolorem sequi odit cumque vero totam. Architecto exercitationem
- minus nemo blanditiis iure numquam eaque.
+ description: Explicabo quibusdam deleniti libero asperiores quasi.
+ Deleniti fuga quas maiores saepe dolore tempore deserunt hic. Necessitatibus
+ quia id adipisci impedit. Quisquam cum nulla culpa laboriosam dolores.
+ Beatae iure repellat eveniet iusto. Excepturi distinctio accusantium
+ veritatis sed eius. Veritatis soluta dicta dolores expedita dolor
+ tempore. Libero dolores eaque nisi sapiente. Non accusantium odit
+ magni distinctio saepe. Voluptates aut error sit blanditiis cupiditate.
+ Odit deleniti officia ad commodi. Consequuntur veniam nihil rerum
+ sint. A nam libero quod optio dolor illum consectetur vero. Delectus
+ iste reprehenderit cupiditate voluptates magni aliquam suscipit.
+ Cupiditate consectetur libero perspiciatis consequatur laudantium
+ neque saepe. Quibusdam totam debitis accusantium distinctio. Adipisci
+ quis inventore ad rem quod officiis dolores ipsam. Rerum qui vitae
+ mollitia adipisci. Omnis odit dolorum aut soluta provident.
+ description_html: |-
+ Explicabo quibusdam deleniti libero asperiores quasi. Deleniti fuga quas maiores saepe dolore tempore deserunt hic. Necessitatibus quia id adipisci impedit.
+ Quisquam cum nulla culpa laboriosam dolores. Beatae iure repellat eveniet iusto. Excepturi distinctio accusantium veritatis sed eius. Veritatis soluta dicta dolores expedita dolor tempore.
+ Libero dolores eaque nisi sapiente. Non accusantium odit magni distinctio saepe. Voluptates aut error sit blanditiis cupiditate.
+ Odit deleniti officia ad commodi. Consequuntur veniam nihil rerum sint. A nam libero quod optio dolor illum consectetur vero. Delectus iste reprehenderit cupiditate voluptates magni aliquam suscipit.
+ Cupiditate consectetur libero perspiciatis consequatur laudantium neque saepe. Quibusdam totam debitis accusantium distinctio. Adipisci quis inventore ad rem quod officiis dolores ipsam. Rerum qui vitae mollitia adipisci. Omnis odit dolorum aut soluta provident.
default_variant_id: variant_UkLWZg9DAJ
thumbnail_url:
tags: []
@@ -11331,16 +11703,16 @@ paths:
display_compare_at_amount:
price_list_id:
variant_id: variant_UkLWZg9DAJ
- created_at: '2026-05-26T16:13:12.353Z'
- updated_at: '2026-05-26T16:13:12.353Z'
+ created_at: '2026-05-26T17:52:59.949Z'
+ updated_at: '2026-05-26T17:52:59.949Z'
original_price:
status: active
- make_active_at: '2025-05-26T16:13:12.328Z'
+ make_active_at: '2025-05-26T17:52:59.925Z'
discontinue_on:
metadata: {}
deleted_at:
- created_at: '2026-05-26T16:13:12.341Z'
- updated_at: '2026-05-26T16:13:12.644Z'
+ created_at: '2026-05-26T17:52:59.936Z'
+ updated_at: '2026-05-26T17:53:00.235Z'
tax_category_id: taxcat_UkLWZg9DAJ
schema:
"$ref": "#/components/schemas/Product"
@@ -11873,8 +12245,8 @@ paths:
example:
data:
- id: pact_UkLWZg9DAJ
- created_at: '2026-05-26T16:13:16.258Z'
- updated_at: '2026-05-26T16:13:16.258Z'
+ created_at: '2026-05-26T17:53:03.605Z'
+ updated_at: '2026-05-26T17:53:03.605Z'
type: free_shipping
promotion_id: promo_UkLWZg9DAJ
preferences: {}
@@ -11935,8 +12307,8 @@ paths:
application/json:
example:
id: pact_UkLWZg9DAJ
- created_at: '2026-05-26T16:13:16.825Z'
- updated_at: '2026-05-26T16:13:16.825Z'
+ created_at: '2026-05-26T17:53:04.171Z'
+ updated_at: '2026-05-26T17:53:04.171Z'
type: free_shipping
promotion_id: promo_UkLWZg9DAJ
preferences: {}
@@ -12046,8 +12418,8 @@ paths:
example:
data:
- id: prorule_UkLWZg9DAJ
- created_at: '2026-05-26T16:13:17.409Z'
- updated_at: '2026-05-26T16:13:17.409Z'
+ created_at: '2026-05-26T17:53:04.802Z'
+ updated_at: '2026-05-26T17:53:04.802Z'
type: currency
promotion_id: promo_UkLWZg9DAJ
preferences:
@@ -12114,8 +12486,8 @@ paths:
application/json:
example:
id: prorule_UkLWZg9DAJ
- created_at: '2026-05-26T16:13:17.988Z'
- updated_at: '2026-05-26T16:13:17.988Z'
+ created_at: '2026-05-26T17:53:05.409Z'
+ updated_at: '2026-05-26T17:53:05.409Z'
type: currency
promotion_id: promo_UkLWZg9DAJ
preferences:
@@ -12188,8 +12560,8 @@ paths:
application/json:
example:
id: prorule_UkLWZg9DAJ
- created_at: '2026-05-26T16:13:18.276Z'
- updated_at: '2026-05-26T16:13:18.552Z'
+ created_at: '2026-05-26T17:53:05.712Z'
+ updated_at: '2026-05-26T17:53:05.992Z'
type: currency
promotion_id: promo_UkLWZg9DAJ
preferences:
@@ -12279,7 +12651,7 @@ paths:
name: Summer Sale
description:
code: summer
- starts_at: '2026-05-26T16:13:18.839Z'
+ starts_at: '2026-05-26T17:53:06.288Z'
expires_at:
usage_limit:
match_policy: all
@@ -12290,8 +12662,8 @@ paths:
code_prefix:
promotion_category_id:
metadata: {}
- created_at: '2026-05-26T16:13:18.840Z'
- updated_at: '2026-05-26T16:13:18.841Z'
+ created_at: '2026-05-26T17:53:06.290Z'
+ updated_at: '2026-05-26T17:53:06.291Z'
store_ids:
- store_UkLWZg9DAJ
action_ids: []
@@ -12397,7 +12769,7 @@ paths:
name: Black Friday
description:
code: blackfriday-os
- starts_at: '2026-05-26T16:13:19.743Z'
+ starts_at: '2026-05-26T17:53:07.202Z'
expires_at:
usage_limit:
match_policy: all
@@ -12408,8 +12780,8 @@ paths:
code_prefix:
promotion_category_id:
metadata: {}
- created_at: '2026-05-26T16:13:19.744Z'
- updated_at: '2026-05-26T16:13:19.763Z'
+ created_at: '2026-05-26T17:53:07.203Z'
+ updated_at: '2026-05-26T17:53:07.223Z'
store_ids:
- store_UkLWZg9DAJ
action_ids:
@@ -12562,7 +12934,7 @@ paths:
name: Summer Sale
description:
code: summer
- starts_at: '2026-05-26T16:13:20.066Z'
+ starts_at: '2026-05-26T17:53:07.518Z'
expires_at:
usage_limit:
match_policy: all
@@ -12573,8 +12945,8 @@ paths:
code_prefix:
promotion_category_id:
metadata: {}
- created_at: '2026-05-26T16:13:20.066Z'
- updated_at: '2026-05-26T16:13:20.067Z'
+ created_at: '2026-05-26T17:53:07.519Z'
+ updated_at: '2026-05-26T17:53:07.520Z'
store_ids:
- store_UkLWZg9DAJ
action_ids: []
@@ -12670,7 +13042,7 @@ paths:
name: Summer Sale
description:
code: summer
- starts_at: '2026-05-26T16:13:20.943Z'
+ starts_at: '2026-05-26T17:53:08.422Z'
expires_at:
usage_limit:
match_policy: all
@@ -12681,8 +13053,8 @@ paths:
code_prefix:
promotion_category_id:
metadata: {}
- created_at: '2026-05-26T16:13:20.944Z'
- updated_at: '2026-05-26T16:13:21.228Z'
+ created_at: '2026-05-26T17:53:08.422Z'
+ updated_at: '2026-05-26T17:53:08.706Z'
store_ids:
- store_UkLWZg9DAJ
action_ids: []
@@ -12977,12 +13349,12 @@ paths:
label: Option Value(s)
description:
preference_schema:
- - key: match_policy
- type: string
- default: any
- key: eligible_values
type: array
default: []
+ - key: match_policy
+ type: string
+ default: any
- type: product
label: Product(s)
description:
@@ -13034,8 +13406,8 @@ paths:
data:
- id: role_UkLWZg9DAJ
name: admin
- created_at: '2026-05-26T16:13:22.193Z'
- updated_at: '2026-05-26T16:13:22.193Z'
+ created_at: '2026-05-26T17:53:09.590Z'
+ updated_at: '2026-05-26T17:53:09.590Z'
meta:
page: 1
limit: 25
@@ -13170,8 +13542,8 @@ paths:
pickup_stock_policy: local
pickup_ready_in_minutes:
pickup_instructions:
- created_at: '2026-05-26T16:13:22.481Z'
- updated_at: '2026-05-26T16:13:22.481Z'
+ created_at: '2026-05-26T17:53:09.882Z'
+ updated_at: '2026-05-26T17:53:09.882Z'
meta:
page: 1
limit: 25
@@ -13282,8 +13654,8 @@ paths:
pickup_stock_policy: local
pickup_ready_in_minutes: 30
pickup_instructions:
- created_at: '2026-05-26T16:13:23.062Z'
- updated_at: '2026-05-26T16:13:23.062Z'
+ created_at: '2026-05-26T17:53:10.464Z'
+ updated_at: '2026-05-26T17:53:10.464Z'
schema:
"$ref": "#/components/schemas/StockLocation"
'422':
@@ -13457,8 +13829,8 @@ paths:
pickup_stock_policy: local
pickup_ready_in_minutes:
pickup_instructions:
- created_at: '2026-05-26T16:13:23.350Z'
- updated_at: '2026-05-26T16:13:23.350Z'
+ created_at: '2026-05-26T17:53:10.752Z'
+ updated_at: '2026-05-26T17:53:10.752Z'
schema:
"$ref": "#/components/schemas/StockLocation"
'404':
@@ -13543,8 +13915,8 @@ paths:
pickup_stock_policy: local
pickup_ready_in_minutes: 45
pickup_instructions:
- created_at: '2026-05-26T16:13:23.913Z'
- updated_at: '2026-05-26T16:13:24.193Z'
+ created_at: '2026-05-26T17:53:11.320Z'
+ updated_at: '2026-05-26T17:53:11.598Z'
schema:
"$ref": "#/components/schemas/StockLocation"
'422':
@@ -13747,8 +14119,8 @@ paths:
data:
- id: sccat_UkLWZg9DAJ
name: Goodwill
- created_at: '2026-05-26T16:13:24.773Z'
- updated_at: '2026-05-26T16:13:24.773Z'
+ created_at: '2026-05-26T17:53:12.195Z'
+ updated_at: '2026-05-26T17:53:12.195Z'
non_expiring: false
meta:
page: 1
@@ -13839,8 +14211,8 @@ paths:
example:
id: sccat_UkLWZg9DAJ
name: Goodwill
- created_at: '2026-05-26T16:13:25.067Z'
- updated_at: '2026-05-26T16:13:25.067Z'
+ created_at: '2026-05-26T17:53:12.490Z'
+ updated_at: '2026-05-26T17:53:12.490Z'
non_expiring: false
schema:
"$ref": "#/components/schemas/StoreCreditCategory"
@@ -13905,8 +14277,8 @@ paths:
preferred_timezone: UTC
preferred_weight_unit: lb
preferred_unit_system: imperial
- created_at: '2026-05-26T16:11:54.992Z'
- updated_at: '2026-05-26T16:13:25.774Z'
+ created_at: '2026-05-26T17:51:43.613Z'
+ updated_at: '2026-05-26T17:53:13.089Z'
url: http://www.example.com:3000
supported_currencies:
- USD
@@ -13977,8 +14349,8 @@ paths:
preferred_timezone: UTC
preferred_weight_unit: lb
preferred_unit_system: imperial
- created_at: '2026-05-26T16:11:54.992Z'
- updated_at: '2026-05-26T16:13:26.386Z'
+ created_at: '2026-05-26T17:51:43.613Z'
+ updated_at: '2026-05-26T17:53:13.698Z'
url: http://www.example.com:3000
supported_currencies:
- USD
@@ -14198,13 +14570,13 @@ paths:
weight_unit: lb
dimensions_unit:
deleted_at:
- created_at: '2026-05-26T16:13:27.811Z'
- updated_at: '2026-05-26T16:13:27.825Z'
+ created_at: '2026-05-26T17:53:15.105Z'
+ updated_at: '2026-05-26T17:53:15.117Z'
tax_category_id: taxcat_UkLWZg9DAJ
available_stock: 0
reserved_quantity: 0
total_on_hand: 0
- product_name: Product 753715
+ product_name: Product 75230
- id: variant_gbHJdmfrXB
product_id: prod_UkLWZg9DAJ
sku: SKU-94
@@ -14215,10 +14587,10 @@ paths:
purchasable: true
in_stock: false
backorderable: true
- weight: 130.85
- height: 166.65
- width: 108.23
- depth: 119.88
+ weight: 172.35
+ height: 76.43
+ width: 163.47
+ depth: 107.29
price:
id: price_gbHJdmfrXB
amount: '19.99'
@@ -14241,8 +14613,8 @@ paths:
option_type_label: Size
image_url:
metadata: {}
- created_at: '2026-05-26T16:13:27.836Z'
- updated_at: '2026-05-26T16:13:27.836Z'
+ created_at: '2026-05-26T17:53:15.130Z'
+ updated_at: '2026-05-26T17:53:15.130Z'
metadata: {}
position: 2
cost_price: '17.0'
@@ -14251,13 +14623,13 @@ paths:
weight_unit: lb
dimensions_unit:
deleted_at:
- created_at: '2026-05-26T16:13:27.833Z'
- updated_at: '2026-05-26T16:13:27.847Z'
+ created_at: '2026-05-26T17:53:15.126Z'
+ updated_at: '2026-05-26T17:53:15.159Z'
tax_category_id: taxcat_UkLWZg9DAJ
available_stock: 0
reserved_quantity: 0
total_on_hand: 0
- product_name: Product 753715
+ product_name: Product 75230
meta:
page: 1
limit: 25
@@ -14368,8 +14740,8 @@ paths:
option_type_label: Size
image_url:
metadata: {}
- created_at: '2026-05-26T16:13:28.503Z'
- updated_at: '2026-05-26T16:13:28.503Z'
+ created_at: '2026-05-26T17:53:15.822Z'
+ updated_at: '2026-05-26T17:53:15.822Z'
metadata: {}
position: 3
cost_price:
@@ -14378,13 +14750,13 @@ paths:
weight_unit: lb
dimensions_unit:
deleted_at:
- created_at: '2026-05-26T16:13:28.507Z'
- updated_at: '2026-05-26T16:13:28.508Z'
+ created_at: '2026-05-26T17:53:15.826Z'
+ updated_at: '2026-05-26T17:53:15.827Z'
tax_category_id: taxcat_UkLWZg9DAJ
available_stock: 0
reserved_quantity: 0
total_on_hand: 0
- product_name: Product 766019
+ product_name: Product 764100
'422':
description: validation error
content:
@@ -14571,10 +14943,10 @@ paths:
purchasable: true
in_stock: false
backorderable: true
- weight: 18.3
- height: 189.2
- width: 53.43
- depth: 41.8
+ weight: 105.13
+ height: 71.4
+ width: 31.83
+ depth: 176.88
price:
id: price_gbHJdmfrXB
amount: '19.99'
@@ -14597,8 +14969,8 @@ paths:
option_type_label: Size
image_url:
metadata: {}
- created_at: '2026-05-26T16:13:28.899Z'
- updated_at: '2026-05-26T16:13:28.899Z'
+ created_at: '2026-05-26T17:53:16.239Z'
+ updated_at: '2026-05-26T17:53:16.239Z'
metadata: {}
position: 2
cost_price: '17.0'
@@ -14607,13 +14979,13 @@ paths:
weight_unit: lb
dimensions_unit:
deleted_at:
- created_at: '2026-05-26T16:13:28.897Z'
- updated_at: '2026-05-26T16:13:28.912Z'
+ created_at: '2026-05-26T17:53:16.230Z'
+ updated_at: '2026-05-26T17:53:16.281Z'
tax_category_id: taxcat_UkLWZg9DAJ
available_stock: 0
reserved_quantity: 0
total_on_hand: 0
- product_name: Product 784102
+ product_name: Product 784672
'404':
description: variant not found
content:
@@ -14692,10 +15064,10 @@ paths:
purchasable: true
in_stock: false
backorderable: true
- weight: 189.23
- height: 159.19
- width: 67.14
- depth: 185.25
+ weight: 21.74
+ height: 52.78
+ width: 42.32
+ depth: 177.31
price:
id: price_gbHJdmfrXB
amount: '19.99'
@@ -14718,8 +15090,8 @@ paths:
option_type_label: Size
image_url:
metadata: {}
- created_at: '2026-05-26T16:13:29.599Z'
- updated_at: '2026-05-26T16:13:29.599Z'
+ created_at: '2026-05-26T17:53:16.962Z'
+ updated_at: '2026-05-26T17:53:16.962Z'
metadata: {}
position: 2
cost_price: '17.0'
@@ -14728,13 +15100,13 @@ paths:
weight_unit: lb
dimensions_unit:
deleted_at:
- created_at: '2026-05-26T16:13:29.597Z'
- updated_at: '2026-05-26T16:13:29.890Z'
+ created_at: '2026-05-26T17:53:16.960Z'
+ updated_at: '2026-05-26T17:53:17.257Z'
tax_category_id: taxcat_UkLWZg9DAJ
available_stock: 0
reserved_quantity: 0
total_on_hand: 0
- product_name: Product 801029
+ product_name: Product 801153
requestBody:
content:
application/json:
@@ -15343,7 +15715,7 @@ components:
id:
type: string
origin:
- type: object
+ type: string
created_at:
type: string
updated_at:
diff --git a/packages/admin-sdk/examples/allowed-origins/create.ts b/packages/admin-sdk/examples/allowed-origins/create.ts
new file mode 100644
index 0000000000..6f7de1b0ea
--- /dev/null
+++ b/packages/admin-sdk/examples/allowed-origins/create.ts
@@ -0,0 +1,15 @@
+import { createAdminClient } from '@spree/admin-sdk'
+
+const client = createAdminClient({
+ baseUrl: 'https://your-store.com',
+ secretKey: 'sk_xxx',
+})
+
+// region:example
+const origin = await client.allowedOrigins.create({
+ origin: 'https://admin.example.com',
+})
+
+// endregion:example
+
+export { origin }
diff --git a/packages/admin-sdk/examples/allowed-origins/delete.ts b/packages/admin-sdk/examples/allowed-origins/delete.ts
new file mode 100644
index 0000000000..c37bc38520
--- /dev/null
+++ b/packages/admin-sdk/examples/allowed-origins/delete.ts
@@ -0,0 +1,10 @@
+import { createAdminClient } from '@spree/admin-sdk'
+
+const client = createAdminClient({
+ baseUrl: 'https://your-store.com',
+ secretKey: 'sk_xxx',
+})
+
+// region:example
+await client.allowedOrigins.delete('ao_xxx')
+// endregion:example
diff --git a/packages/admin-sdk/examples/allowed-origins/get.ts b/packages/admin-sdk/examples/allowed-origins/get.ts
new file mode 100644
index 0000000000..7f6a8d3ef8
--- /dev/null
+++ b/packages/admin-sdk/examples/allowed-origins/get.ts
@@ -0,0 +1,13 @@
+import { createAdminClient } from '@spree/admin-sdk'
+
+const client = createAdminClient({
+ baseUrl: 'https://your-store.com',
+ secretKey: 'sk_xxx',
+})
+
+// region:example
+const origin = await client.allowedOrigins.get('ao_xxx')
+
+// endregion:example
+
+export { origin }
diff --git a/packages/admin-sdk/examples/allowed-origins/list.ts b/packages/admin-sdk/examples/allowed-origins/list.ts
new file mode 100644
index 0000000000..440f82219d
--- /dev/null
+++ b/packages/admin-sdk/examples/allowed-origins/list.ts
@@ -0,0 +1,13 @@
+import { createAdminClient } from '@spree/admin-sdk'
+
+const client = createAdminClient({
+ baseUrl: 'https://your-store.com',
+ secretKey: 'sk_xxx',
+})
+
+// region:example
+const { data: origins } = await client.allowedOrigins.list()
+
+// endregion:example
+
+export { origins }
diff --git a/packages/admin-sdk/examples/allowed-origins/update.ts b/packages/admin-sdk/examples/allowed-origins/update.ts
new file mode 100644
index 0000000000..71c05bf33d
--- /dev/null
+++ b/packages/admin-sdk/examples/allowed-origins/update.ts
@@ -0,0 +1,15 @@
+import { createAdminClient } from '@spree/admin-sdk'
+
+const client = createAdminClient({
+ baseUrl: 'https://your-store.com',
+ secretKey: 'sk_xxx',
+})
+
+// region:example
+const origin = await client.allowedOrigins.update('ao_xxx', {
+ origin: 'https://www.example.com',
+})
+
+// endregion:example
+
+export { origin }
diff --git a/packages/admin-sdk/src/admin-client.ts b/packages/admin-sdk/src/admin-client.ts
index 56b8c5750b..edf98b4f4e 100644
--- a/packages/admin-sdk/src/admin-client.ts
+++ b/packages/admin-sdk/src/admin-client.ts
@@ -69,6 +69,8 @@ export interface MeResponse {
import type {
AdminUserUpdateParams,
+ AllowedOriginCreateParams,
+ AllowedOriginUpdateParams,
ApiKeyCreateParams,
ApiKeyUpdateParams,
CustomerAddressParams,
@@ -139,6 +141,7 @@ import type {
Address,
Adjustment,
AdminUser,
+ AllowedOrigin,
ApiKey,
Category,
Country,
@@ -2025,6 +2028,50 @@ export class AdminClient {
this.request<ApiKey>('PATCH', `/api_keys/${id}/revoke`, options),
}
+ // ============================================
+ // Allowed Origins (CORS allowlist for admin cookie auth)
+ // ============================================
+
+ /**
+ * Origins permitted to call the admin API from a browser. Backs the
+ * `Rack::Cors` allowlist and the CSRF boundary of the admin cookie session
+ * (see `docs/plans/5.5-admin-auth-cookie-refresh.md`). Each entry is a
+ * bare `scheme://host[:port]` — no paths, queries, or fragments.
+ */
+ readonly allowedOrigins = {
+ list: (
+ params?: ListParams & Record<string, unknown>,
+ options?: RequestOptions,
+ ): Promise<PaginatedResponse<AllowedOrigin>> =>
+ this.request<PaginatedResponse<AllowedOrigin>>('GET', '/allowed_origins', {
+ ...options,
+ params: params ? transformListParams(params) : undefined,
+ }),
+
+ get: (
+ id: string,
+ params?: { expand?: string[] },
+ options?: RequestOptions,
+ ): Promise<AllowedOrigin> =>
+ this.request<AllowedOrigin>('GET', `/allowed_origins/${id}`, {
+ ...options,
+ params: getParams(params),
+ }),
+
+ create: (params: AllowedOriginCreateParams, options?: RequestOptions): Promise<AllowedOrigin> =>
+ this.request<AllowedOrigin>('POST', '/allowed_origins', { ...options, body: params }),
+
+ update: (
+ id: string,
+ params: AllowedOriginUpdateParams,
+ options?: RequestOptions,
+ ): Promise<AllowedOrigin> =>
+ this.request<AllowedOrigin>('PATCH', `/allowed_origins/${id}`, { ...options, body: params }),
+
+ delete: (id: string, options?: RequestOptions): Promise<void> =>
+ this.request<void>('DELETE', `/allowed_origins/${id}`, options),
+ }
+
// ============================================
// Roles (read-only — for staff role pickers)
// ============================================
diff --git a/packages/admin-sdk/src/params.ts b/packages/admin-sdk/src/params.ts
index 549af38a04..15edf617f6 100644
--- a/packages/admin-sdk/src/params.ts
+++ b/packages/admin-sdk/src/params.ts
@@ -509,6 +509,19 @@ export interface StockTransferCreateParams {
variants: Array<{ variant_id: string; quantity: number }>
}
+export interface AllowedOriginCreateParams {
+ /**
+ * Origin to allow in admin CORS preflight checks. Must be a bare
+ * `scheme://host[:port]` (no path, query, or fragment) and use `http` or
+ * `https`.
+ */
+ origin: string
+}
+
+export interface AllowedOriginUpdateParams {
+ origin?: string
+}
+
export interface TaxCategoryCreateParams {
name: string
tax_code?: string | null
diff --git a/packages/admin-sdk/src/types/generated/AllowedOrigin.ts b/packages/admin-sdk/src/types/generated/AllowedOrigin.ts
index 30a129831a..4d84bbc58c 100644
--- a/packages/admin-sdk/src/types/generated/AllowedOrigin.ts
+++ b/packages/admin-sdk/src/types/generated/AllowedOrigin.ts
@@ -1,10 +1,10 @@
-// Typelizer digest 7e678dcb95f976e68d167d03268f9556
+// Typelizer digest de5936cbb2fdee661ce38e1b1fc084e0
//
// DO NOT MODIFY: This file was automatically generated by Typelizer.
interface AllowedOrigin {
id: string;
- origin: unknown;
+ origin: string;
created_at: string;
updated_at: string;
store_id: string;
diff --git a/packages/admin/e2e/allowed-origins.spec.ts b/packages/admin/e2e/allowed-origins.spec.ts
new file mode 100644
index 0000000000..aaa566f79e
--- /dev/null
+++ b/packages/admin/e2e/allowed-origins.spec.ts
@@ -0,0 +1,86 @@
+import { expect, type Page, test } from '@playwright/test'
+import { gotoIndex, login, openRowMenu, rowButton } from './helpers'
+
+const ALLOWED_ORIGINS_PATH = (storeId: string) => `/${storeId}/settings/allowed-origins`
+const CTA = /add allowed origin/i
+
+async function createAllowedOrigin(page: Page, origin: string) {
+ await page.getByRole('button', { name: /add allowed origin/i }).click()
+ await expect(page.getByRole('heading', { name: /add allowed origin/i })).toBeVisible()
+
+ await page.locator('#origin').fill(origin)
+
+ await page.getByRole('button', { name: /add origin/i }).click()
+}
+
+test.describe('allowed origins', () => {
+ test('lists allowed origins', async ({ page }) => {
+ const creds = await login(page)
+ await gotoIndex(page, ALLOWED_ORIGINS_PATH(creds.store_id), CTA)
+ })
+
+ test('creates a new allowed origin', async ({ page }) => {
+ const creds = await login(page)
+ await gotoIndex(page, ALLOWED_ORIGINS_PATH(creds.store_id), CTA)
+
+ const origin = `https://e2e-${Date.now()}.example.com`
+
+ await createAllowedOrigin(page, origin)
+
+ await expect(rowButton(page, origin)).toBeVisible({ timeout: 15_000 })
+ })
+
+ test('shows inline validation for a malformed origin', async ({ page }) => {
+ const creds = await login(page)
+ await gotoIndex(page, ALLOWED_ORIGINS_PATH(creds.store_id), CTA)
+
+ await page.getByRole('button', { name: /add allowed origin/i }).click()
+ await expect(page.getByRole('heading', { name: /add allowed origin/i })).toBeVisible()
+
+ await page.locator('#origin').fill('not a url')
+ await page.getByRole('button', { name: /add origin/i }).click()
+
+ await expect(page.getByText(/must be a bare origin/i)).toBeVisible()
+ })
+
+ test('edits an allowed origin', async ({ page }) => {
+ const creds = await login(page)
+ await gotoIndex(page, ALLOWED_ORIGINS_PATH(creds.store_id), CTA)
+
+ const suffix = Date.now()
+ const original = `https://edit-${suffix}.example.com`
+ const updated = `https://edit-${suffix}.example.net`
+
+ await createAllowedOrigin(page, original)
+ await expect(rowButton(page, original)).toBeVisible({ timeout: 15_000 })
+
+ await rowButton(page, original).click()
+ await expect(page.getByRole('heading', { name: original })).toBeVisible({ timeout: 15_000 })
+ await expect(page.locator('#origin')).toHaveValue(original)
+
+ await page.locator('#origin').fill(updated)
+ await page.getByRole('button', { name: /^save$/i }).click()
+
+ await expect(rowButton(page, updated)).toBeVisible({ timeout: 15_000 })
+ })
+
+ test('deletes an allowed origin', async ({ page }) => {
+ const creds = await login(page)
+ await gotoIndex(page, ALLOWED_ORIGINS_PATH(creds.store_id), CTA)
+
+ const origin = `https://del-${Date.now()}.example.com`
+
+ await createAllowedOrigin(page, origin)
+ await expect(rowButton(page, origin)).toBeVisible({ timeout: 15_000 })
+
+ await openRowMenu(page, origin)
+ await page.getByRole('menuitem', { name: /^delete$/i }).click()
+ await expect(page.getByRole('heading', { name: /remove allowed origin\?/i })).toBeVisible()
+ await page
+ .getByRole('dialog')
+ .getByRole('button', { name: /^delete$/i })
+ .click()
+
+ await expect(rowButton(page, origin)).toHaveCount(0, { timeout: 15_000 })
+ })
+})
diff --git a/packages/admin/src/hooks/use-allowed-origins.ts b/packages/admin/src/hooks/use-allowed-origins.ts
new file mode 100644
index 0000000000..7076a7ddb3
--- /dev/null
+++ b/packages/admin/src/hooks/use-allowed-origins.ts
@@ -0,0 +1,54 @@
+import type {
+ AllowedOrigin,
+ AllowedOriginCreateParams,
+ AllowedOriginUpdateParams,
+} from '@spree/admin-sdk'
+import { useQuery, useQueryClient } from '@tanstack/react-query'
+import { adminClient } from '@/client'
+import { useResourceMutation } from '@/hooks/use-resource-mutation'
+
+export const allowedOriginsQueryKey = ['allowed-origins'] as const
+
+export function allowedOriginQueryKey(id: string) {
+ return ['allowed-origins', id] as const
+}
+
+export function useAllowedOrigin(id: string | undefined) {
+ return useQuery({
+ queryKey: id ? allowedOriginQueryKey(id) : ['allowed-origins', 'noop'],
+ queryFn: () => adminClient.allowedOrigins.get(id as string),
+ enabled: !!id,
+ })
+}
+
+export function useCreateAllowedOrigin() {
+ return useResourceMutation<AllowedOrigin, Error, AllowedOriginCreateParams>({
+ mutationFn: (params) => adminClient.allowedOrigins.create(params),
+ invalidate: [allowedOriginsQueryKey],
+ successMessage: 'Allowed origin added',
+ errorMessage: 'Failed to add allowed origin',
+ })
+}
+
+export function useUpdateAllowedOrigin(id: string) {
+ return useResourceMutation<AllowedOrigin, Error, AllowedOriginUpdateParams>({
+ mutationFn: (params) => adminClient.allowedOrigins.update(id, params),
+ invalidate: [allowedOriginsQueryKey, allowedOriginQueryKey(id)],
+ successMessage: 'Allowed origin updated',
+ errorMessage: 'Failed to update allowed origin',
+ })
+}
+
+export function useDeleteAllowedOrigin() {
+ const queryClient = useQueryClient()
+
+ return useResourceMutation<void, Error, string>({
+ mutationFn: (id) => adminClient.allowedOrigins.delete(id),
+ invalidate: [allowedOriginsQueryKey],
+ successMessage: 'Allowed origin removed',
+ errorMessage: 'Failed to remove allowed origin',
+ onSuccess: (_data, id) => {
+ queryClient.removeQueries({ queryKey: allowedOriginQueryKey(id) })
+ },
+ })
+}
diff --git a/packages/admin/src/lib/permissions.ts b/packages/admin/src/lib/permissions.ts
index 9207fe98d1..04c91714e5 100644
--- a/packages/admin/src/lib/permissions.ts
+++ b/packages/admin/src/lib/permissions.ts
@@ -13,6 +13,7 @@ export const Subject = {
CustomerGroup: 'Spree::CustomerGroup',
AdminUser: 'Spree::AdminUser',
ApiKey: 'Spree::ApiKey',
+ AllowedOrigin: 'Spree::AllowedOrigin',
Store: 'Spree::Store',
Taxon: 'Spree::Taxon',
Taxonomy: 'Spree::Taxonomy',
diff --git a/packages/admin/src/locales/en.json b/packages/admin/src/locales/en.json
index 6eed4ca238..5aa83915f7 100644
--- a/packages/admin/src/locales/en.json
+++ b/packages/admin/src/locales/en.json
@@ -114,8 +114,7 @@
"batch": "Batch",
"customer": "Customer",
"issued_by": "Issued by",
- "expires": "Expires",
- "created": "Created"
+ "expires": "Expires"
},
"table": {
"search_placeholder": "Search by code…",
@@ -323,6 +322,13 @@
"help": "Setting this demotes the previous default. Products without an explicit category fall back to this one."
}
},
+ "allowed_origin": {
+ "origin": {
+ "label": "Origin",
+ "placeholder": "https://admin.example.com",
+ "help": "Bare scheme + host (+ optional port). No path, query, or fragment."
+ }
+ },
"invitation_acceptance": {
"password": { "label": "Password" },
"password_confirmation": { "label": "Confirm password" }
@@ -1028,6 +1034,10 @@
"edit_sheet_title": "Edit stock location",
"section_address": "Address",
"search_placeholder": "Search stock locations…"
+ },
+ "allowed_origins": {
+ "add_sheet_title": "Add allowed origin",
+ "edit_sheet_title": "Edit allowed origin"
}
},
"promotions": {
@@ -1478,6 +1488,22 @@
"message": "{{label}} will be removed along with every value stored for it."
}
},
+ "allowed_origins": {
+ "add_cta": "Add allowed origin",
+ "create_label": "Add origin",
+ "create_description": "Browsers loaded from this origin can call the admin API. The CORS allowlist and admin cookie session both rely on this list — keep it tight.",
+ "edit_description": "Updating an origin immediately changes who can call the admin API from a browser.",
+ "table_title": "Allowed origins",
+ "search_placeholder": "Search by origin…",
+ "empty": "No allowed origins yet",
+ "validation": {
+ "bare_origin": "Must be a bare origin (e.g. https://shop.example.com) — no path, query, or fragment"
+ },
+ "delete_confirm": {
+ "title": "Remove allowed origin?",
+ "message": "{{origin}} will no longer be able to call the admin API from a browser. Existing server-to-server requests are not affected."
+ }
+ },
"stock_locations": {
"add_cta": "Add stock location",
"create_label": "Create stock location",
diff --git a/packages/admin/src/nav/settings.ts b/packages/admin/src/nav/settings.ts
index fbcac62d97..5d67186207 100644
--- a/packages/admin/src/nav/settings.ts
+++ b/packages/admin/src/nav/settings.ts
@@ -1,6 +1,7 @@
import {
CreditCardIcon,
GlobeIcon,
+ GlobeLockIcon,
KeyRoundIcon,
PercentIcon,
StoreIcon,
@@ -95,3 +96,13 @@ settingsNav.add({
position: 200,
subject: Subject.ApiKey,
})
+
+settingsNav.add({
+ key: 'settings.allowed-origins',
+ label: 'Allowed origins',
+ path: '/allowed-origins',
+ icon: GlobeLockIcon,
+ group: 'team',
+ position: 300,
+ subject: Subject.AllowedOrigin,
+})
diff --git a/packages/admin/src/routeTree.gen.ts b/packages/admin/src/routeTree.gen.ts
index 7c164e8a6b..7ac6c73ee5 100644
--- a/packages/admin/src/routeTree.gen.ts
+++ b/packages/admin/src/routeTree.gen.ts
@@ -29,6 +29,7 @@ import { Route as AuthenticatedStoreIdSettingsPaymentMethodsRouteImport } from '
import { Route as AuthenticatedStoreIdSettingsMarketsRouteImport } from './routes/_authenticated/$storeId/settings/markets'
import { Route as AuthenticatedStoreIdSettingsCustomFieldDefinitionsRouteImport } from './routes/_authenticated/$storeId/settings/custom-field-definitions'
import { Route as AuthenticatedStoreIdSettingsApiKeysRouteImport } from './routes/_authenticated/$storeId/settings/api-keys'
+import { Route as AuthenticatedStoreIdSettingsAllowedOriginsRouteImport } from './routes/_authenticated/$storeId/settings/allowed-origins'
import { Route as AuthenticatedStoreIdPromotionsNewRouteImport } from './routes/_authenticated/$storeId/promotions/new'
import { Route as AuthenticatedStoreIdPromotionsGiftCardsRouteImport } from './routes/_authenticated/$storeId/promotions/gift-cards'
import { Route as AuthenticatedStoreIdPromotionsPromotionIdRouteImport } from './routes/_authenticated/$storeId/promotions/$promotionId'
@@ -159,6 +160,12 @@ const AuthenticatedStoreIdSettingsApiKeysRoute =
path: '/api-keys',
getParentRoute: () => AuthenticatedStoreIdSettingsRoute,
} as any)
+const AuthenticatedStoreIdSettingsAllowedOriginsRoute =
+ AuthenticatedStoreIdSettingsAllowedOriginsRouteImport.update({
+ id: '/allowed-origins',
+ path: '/allowed-origins',
+ getParentRoute: () => AuthenticatedStoreIdSettingsRoute,
+ } as any)
const AuthenticatedStoreIdPromotionsNewRoute =
AuthenticatedStoreIdPromotionsNewRouteImport.update({
id: '/promotions/new',
@@ -262,6 +269,7 @@ export interface FileRoutesByFullPath {
'/$storeId/promotions/$promotionId': typeof AuthenticatedStoreIdPromotionsPromotionIdRoute
'/$storeId/promotions/gift-cards': typeof AuthenticatedStoreIdPromotionsGiftCardsRoute
'/$storeId/promotions/new': typeof AuthenticatedStoreIdPromotionsNewRoute
+ '/$storeId/settings/allowed-origins': typeof AuthenticatedStoreIdSettingsAllowedOriginsRoute
'/$storeId/settings/api-keys': typeof AuthenticatedStoreIdSettingsApiKeysRoute
'/$storeId/settings/custom-field-definitions': typeof AuthenticatedStoreIdSettingsCustomFieldDefinitionsRoute
'/$storeId/settings/markets': typeof AuthenticatedStoreIdSettingsMarketsRoute
@@ -295,6 +303,7 @@ export interface FileRoutesByTo {
'/$storeId/promotions/$promotionId': typeof AuthenticatedStoreIdPromotionsPromotionIdRoute
'/$storeId/promotions/gift-cards': typeof AuthenticatedStoreIdPromotionsGiftCardsRoute
'/$storeId/promotions/new': typeof AuthenticatedStoreIdPromotionsNewRoute
+ '/$storeId/settings/allowed-origins': typeof AuthenticatedStoreIdSettingsAllowedOriginsRoute
'/$storeId/settings/api-keys': typeof AuthenticatedStoreIdSettingsApiKeysRoute
'/$storeId/settings/custom-field-definitions': typeof AuthenticatedStoreIdSettingsCustomFieldDefinitionsRoute
'/$storeId/settings/markets': typeof AuthenticatedStoreIdSettingsMarketsRoute
@@ -332,6 +341,7 @@ export interface FileRoutesById {
'/_authenticated/$storeId/promotions/$promotionId': typeof AuthenticatedStoreIdPromotionsPromotionIdRoute
'/_authenticated/$storeId/promotions/gift-cards': typeof AuthenticatedStoreIdPromotionsGiftCardsRoute
'/_authenticated/$storeId/promotions/new': typeof AuthenticatedStoreIdPromotionsNewRoute
+ '/_authenticated/$storeId/settings/allowed-origins': typeof AuthenticatedStoreIdSettingsAllowedOriginsRoute
'/_authenticated/$storeId/settings/api-keys': typeof AuthenticatedStoreIdSettingsApiKeysRoute
'/_authenticated/$storeId/settings/custom-field-definitions': typeof AuthenticatedStoreIdSettingsCustomFieldDefinitionsRoute
'/_authenticated/$storeId/settings/markets': typeof AuthenticatedStoreIdSettingsMarketsRoute
@@ -369,6 +379,7 @@ export interface FileRouteTypes {
| '/$storeId/promotions/$promotionId'
| '/$storeId/promotions/gift-cards'
| '/$storeId/promotions/new'
+ | '/$storeId/settings/allowed-origins'
| '/$storeId/settings/api-keys'
| '/$storeId/settings/custom-field-definitions'
| '/$storeId/settings/markets'
@@ -402,6 +413,7 @@ export interface FileRouteTypes {
| '/$storeId/promotions/$promotionId'
| '/$storeId/promotions/gift-cards'
| '/$storeId/promotions/new'
+ | '/$storeId/settings/allowed-origins'
| '/$storeId/settings/api-keys'
| '/$storeId/settings/custom-field-definitions'
| '/$storeId/settings/markets'
@@ -438,6 +450,7 @@ export interface FileRouteTypes {
| '/_authenticated/$storeId/promotions/$promotionId'
| '/_authenticated/$storeId/promotions/gift-cards'
| '/_authenticated/$storeId/promotions/new'
+ | '/_authenticated/$storeId/settings/allowed-origins'
| '/_authenticated/$storeId/settings/api-keys'
| '/_authenticated/$storeId/settings/custom-field-definitions'
| '/_authenticated/$storeId/settings/markets'
@@ -604,6 +617,13 @@ declare module '@tanstack/react-router' {
preLoaderRoute: typeof AuthenticatedStoreIdSettingsApiKeysRouteImport
parentRoute: typeof AuthenticatedStoreIdSettingsRoute
}
+ '/_authenticated/$storeId/settings/allowed-origins': {
+ id: '/_authenticated/$storeId/settings/allowed-origins'
+ path: '/allowed-origins'
+ fullPath: '/$storeId/settings/allowed-origins'
+ preLoaderRoute: typeof AuthenticatedStoreIdSettingsAllowedOriginsRouteImport
+ parentRoute: typeof AuthenticatedStoreIdSettingsRoute
+ }
'/_authenticated/$storeId/promotions/new': {
id: '/_authenticated/$storeId/promotions/new'
path: '/promotions/new'
@@ -706,6 +726,7 @@ declare module '@tanstack/react-router' {
}
interface AuthenticatedStoreIdSettingsRouteChildren {
+ AuthenticatedStoreIdSettingsAllowedOriginsRoute: typeof AuthenticatedStoreIdSettingsAllowedOriginsRoute
AuthenticatedStoreIdSettingsApiKeysRoute: typeof AuthenticatedStoreIdSettingsApiKeysRoute
AuthenticatedStoreIdSettingsCustomFieldDefinitionsRoute: typeof AuthenticatedStoreIdSettingsCustomFieldDefinitionsRoute
AuthenticatedStoreIdSettingsMarketsRoute: typeof AuthenticatedStoreIdSettingsMarketsRoute
@@ -719,6 +740,8 @@ interface AuthenticatedStoreIdSettingsRouteChildren {
const AuthenticatedStoreIdSettingsRouteChildren: AuthenticatedStoreIdSettingsRouteChildren =
{
+ AuthenticatedStoreIdSettingsAllowedOriginsRoute:
+ AuthenticatedStoreIdSettingsAllowedOriginsRoute,
AuthenticatedStoreIdSettingsApiKeysRoute:
AuthenticatedStoreIdSettingsApiKeysRoute,
AuthenticatedStoreIdSettingsCustomFieldDefinitionsRoute:
diff --git a/packages/admin/src/routes/_authenticated/$storeId/settings/allowed-origins.tsx b/packages/admin/src/routes/_authenticated/$storeId/settings/allowed-origins.tsx
new file mode 100644
index 0000000000..a390cbdead
--- /dev/null
+++ b/packages/admin/src/routes/_authenticated/$storeId/settings/allowed-origins.tsx
@@ -0,0 +1,320 @@
+import { zodResolver } from '@hookform/resolvers/zod'
+import type { AllowedOrigin, AllowedOriginCreateParams } from '@spree/admin-sdk'
+import { createFileRoute, useNavigate } from '@tanstack/react-router'
+import { PlusIcon } from 'lucide-react'
+import { type UseFormReturn, useForm } from 'react-hook-form'
+import { useTranslation } from 'react-i18next'
+import { z } from 'zod/v4'
+import { adminClient } from '@/client'
+import { Can } from '@/components/spree/can'
+import { useConfirm } from '@/components/spree/confirm-dialog'
+import { ResourceTable, resourceSearchSchema } from '@/components/spree/resource-table'
+import { RowActions } from '@/components/spree/row-actions'
+import { useRowClickBridge } from '@/components/spree/row-click-bridge'
+import { Button } from '@/components/ui/button'
+import { Field, FieldError, FieldGroup, FieldLabel } from '@/components/ui/field'
+import { Input } from '@/components/ui/input'
+import {
+ Sheet,
+ SheetContent,
+ SheetDescription,
+ SheetFooter,
+ SheetHeader,
+ SheetTitle,
+} from '@/components/ui/sheet'
+import {
+ useAllowedOrigin,
+ useCreateAllowedOrigin,
+ useDeleteAllowedOrigin,
+ useUpdateAllowedOrigin,
+} from '@/hooks/use-allowed-origins'
+import { mapSpreeErrorsToForm } from '@/lib/form-errors'
+import { i18n } from '@/lib/i18n'
+import { Subject } from '@/lib/permissions'
+import { requiredMessage } from '@/lib/validation-messages'
+import { usePermissions } from '@/providers/permission-provider'
+import '@/tables/allowed-origins'
+
+// Block paths, queries, fragments, and trailing slashes — the backend rejects
+// them with `:must_be_origin_only`. Catching them client-side gives an
+// immediate inline error instead of waiting for a round trip.
+const allowedOriginFormSchema = z.object({
+ origin: z
+ .string()
+ .trim()
+ .min(1, { error: requiredMessage('allowed_origin.origin') })
+ .regex(/^https?:\/\/[^/?#\s]+$/i, {
+ error: () => i18n.t('admin.allowed_origins.validation.bare_origin'),
+ }),
+})
+
+type AllowedOriginFormValues = z.infer<typeof allowedOriginFormSchema>
+
+const DEFAULT_VALUES: AllowedOriginFormValues = { origin: '' }
+
+const allowedOriginsSearchSchema = resourceSearchSchema.extend({
+ edit: z.string().optional(),
+ new: z.coerce.boolean().optional(),
+})
+
+export const Route = createFileRoute('/_authenticated/$storeId/settings/allowed-origins')({
+ validateSearch: allowedOriginsSearchSchema,
+ component: AllowedOriginsPage,
+})
+
+function AllowedOriginsPage() {
+ const { t } = useTranslation()
+ const search = Route.useSearch() as z.infer<typeof allowedOriginsSearchSchema>
+ const navigate = useNavigate()
+ const confirm = useConfirm()
+ const deleteMutation = useDeleteAllowedOrigin()
+ const { permissions } = usePermissions()
+
+ const isCreating = !!search.new
+ // `new` wins over `edit` when both are present — prevents both sheets
+ // rendering at once from a stale URL.
+ const editId = isCreating ? undefined : search.edit
+
+ const closeSheet = () =>
+ navigate({
+ search: (prev: Record<string, unknown>) => {
+ const { edit: _e, new: _n, ...rest } = prev
+ return rest as never
+ },
+ })
+
+ const openCreate = () =>
+ navigate({
+ search: (prev: Record<string, unknown>) => {
+ const { edit: _e, ...rest } = prev
+ return { ...rest, new: true } as never
+ },
+ })
+
+ const openEdit = (id: string) =>
+ navigate({
+ search: (prev: Record<string, unknown>) => {
+ const { new: _n, ...rest } = prev
+ return { ...rest, edit: id } as never
+ },
+ })
+
+ useRowClickBridge('data-allowed-origin-id', openEdit)
+
+ async function handleDelete(origin: AllowedOrigin) {
+ const ok = await confirm({
+ title: t('admin.allowed_origins.delete_confirm.title'),
+ message: t('admin.allowed_origins.delete_confirm.message', { origin: origin.origin }),
+ variant: 'destructive',
+ confirmLabel: t('admin.actions.delete'),
+ })
+ if (!ok) return
+ await deleteMutation.mutateAsync(origin.id).catch(() => undefined)
+ }
+
+ return (
+ <>
+ <ResourceTable<AllowedOrigin>
+ tableKey="allowed-origins"
+ queryKey="allowed-origins"
+ queryFn={(params) => adminClient.allowedOrigins.list(params)}
+ searchParams={search}
+ rowActions={(origin) => (
+ <RowActions
+ actions={[
+ { key: 'edit', onSelect: () => openEdit(origin.id) },
+ {
+ key: 'delete',
+ destructive: true,
+ visible: permissions.can('destroy', Subject.AllowedOrigin),
+ disabled: deleteMutation.isPending,
+ onSelect: () => handleDelete(origin),
+ },
+ ]}
+ />
+ )}
+ actions={
+ <Can I="create" a={Subject.AllowedOrigin}>
+ <Button size="sm" className="h-[2.125rem]" onClick={openCreate}>
+ <PlusIcon className="size-4" />
+ {t('admin.allowed_origins.add_cta')}
+ </Button>
+ </Can>
+ }
+ />
+
+ {isCreating && <CreateAllowedOriginSheet open onOpenChange={(o) => !o && closeSheet()} />}
+ {editId && (
+ <EditAllowedOriginSheet id={editId} open onOpenChange={(o) => !o && closeSheet()} />
+ )}
+ </>
+ )
+}
+
+function CreateAllowedOriginSheet({
+ open,
+ onOpenChange,
+}: {
+ open: boolean
+ onOpenChange: (open: boolean) => void
+}) {
+ const { t } = useTranslation()
+ const createMutation = useCreateAllowedOrigin()
+ const form = useForm<AllowedOriginFormValues>({
+ resolver: zodResolver(allowedOriginFormSchema),
+ defaultValues: DEFAULT_VALUES,
+ })
+
+ async function onSubmit(values: AllowedOriginFormValues) {
+ try {
+ await createMutation.mutateAsync(values as AllowedOriginCreateParams)
+ form.reset(DEFAULT_VALUES)
+ onOpenChange(false)
+ } catch (err) {
+ if (!mapSpreeErrorsToForm(err, form.setError)) throw err
+ }
+ }
+
+ return (
+ <Sheet
+ open={open}
+ onOpenChange={(next) => {
+ if (!next) form.reset(DEFAULT_VALUES)
+ onOpenChange(next)
+ }}
+ >
+ <SheetContent>
+ <SheetHeader>
+ <SheetTitle>{t('admin.pages.settings.allowed_origins.add_sheet_title')}</SheetTitle>
+ <SheetDescription>{t('admin.allowed_origins.create_description')}</SheetDescription>
+ </SheetHeader>
+ <form onSubmit={form.handleSubmit(onSubmit)} className="flex min-h-0 flex-1 flex-col">
+ <div className="flex flex-1 flex-col gap-4 overflow-y-auto p-4">
+ <AllowedOriginFormFields form={form} />
+ </div>
+ <SheetFooter>
+ <Button
+ type="button"
+ variant="outline"
+ size="sm"
+ onClick={() => onOpenChange(false)}
+ disabled={form.formState.isSubmitting}
+ >
+ {t('admin.actions.cancel')}
+ </Button>
+ <Button type="submit" size="sm" disabled={form.formState.isSubmitting}>
+ {form.formState.isSubmitting
+ ? t('admin.actions.creating')
+ : t('admin.allowed_origins.create_label')}
+ </Button>
+ </SheetFooter>
+ </form>
+ </SheetContent>
+ </Sheet>
+ )
+}
+
+function EditAllowedOriginSheet({
+ id,
+ open,
+ onOpenChange,
+}: {
+ id: string
+ open: boolean
+ onOpenChange: (open: boolean) => void
+}) {
+ const { t } = useTranslation()
+ const { data: allowedOrigin, isLoading } = useAllowedOrigin(id)
+ const updateMutation = useUpdateAllowedOrigin(id)
+
+ // `values` + `keepDirtyValues` syncs server data into the form while
+ // preserving any in-progress edits — protects against background refetches
+ // wiping the user's input.
+ const form = useForm<AllowedOriginFormValues>({
+ resolver: zodResolver(allowedOriginFormSchema),
+ defaultValues: DEFAULT_VALUES,
+ values: allowedOrigin ? { origin: allowedOrigin.origin } : undefined,
+ resetOptions: { keepDirtyValues: true },
+ })
+
+ async function onSubmit(values: AllowedOriginFormValues) {
+ try {
+ await updateMutation.mutateAsync(values)
+ form.reset(values)
+ onOpenChange(false)
+ } catch (err) {
+ if (!mapSpreeErrorsToForm(err, form.setError)) throw err
+ }
+ }
+
+ return (
+ <Sheet open={open} onOpenChange={onOpenChange}>
+ <SheetContent>
+ <SheetHeader>
+ <SheetTitle>
+ {allowedOrigin?.origin ?? t('admin.pages.settings.allowed_origins.edit_sheet_title')}
+ </SheetTitle>
+ <SheetDescription>{t('admin.allowed_origins.edit_description')}</SheetDescription>
+ </SheetHeader>
+ {isLoading ? (
+ <div className="p-4 text-sm text-muted-foreground">{t('admin.common.loading')}</div>
+ ) : (
+ <form onSubmit={form.handleSubmit(onSubmit)} className="flex min-h-0 flex-1 flex-col">
+ <div className="flex flex-1 flex-col gap-4 overflow-y-auto p-4">
+ <AllowedOriginFormFields form={form} />
+ </div>
+ <SheetFooter>
+ <Button
+ type="button"
+ variant="outline"
+ size="sm"
+ onClick={() => onOpenChange(false)}
+ disabled={form.formState.isSubmitting}
+ >
+ {t('admin.actions.cancel')}
+ </Button>
+ <Button
+ type="submit"
+ size="sm"
+ disabled={form.formState.isSubmitting || !form.formState.isDirty}
+ >
+ {form.formState.isSubmitting ? t('admin.actions.saving') : t('admin.actions.save')}
+ </Button>
+ </SheetFooter>
+ </form>
+ )}
+ </SheetContent>
+ </Sheet>
+ )
+}
+
+function AllowedOriginFormFields({ form }: { form: UseFormReturn<AllowedOriginFormValues> }) {
+ const { t } = useTranslation()
+ const { errors } = form.formState
+ return (
+ <FieldGroup>
+ {errors.root?.message && (
+ <p className="text-sm text-destructive" role="alert">
+ {errors.root.message}
+ </p>
+ )}
+ <Field>
+ <FieldLabel htmlFor="origin">{t('admin.fields.allowed_origin.origin.label')}</FieldLabel>
+ <Input
+ id="origin"
+ autoFocus
+ autoComplete="off"
+ spellCheck={false}
+ placeholder={t('admin.fields.allowed_origin.origin.placeholder')}
+ aria-invalid={!!errors.origin || undefined}
+ aria-describedby="origin-help"
+ {...form.register('origin')}
+ />
+ <span id="origin-help" className="text-xs text-muted-foreground">
+ {t('admin.fields.allowed_origin.origin.help')}
+ </span>
+ <FieldError errors={[errors.origin]} />
+ </Field>
+ </FieldGroup>
+ )
+}
diff --git a/packages/admin/src/tables/allowed-origins.tsx b/packages/admin/src/tables/allowed-origins.tsx
new file mode 100644
index 0000000000..aedb293ccc
--- /dev/null
+++ b/packages/admin/src/tables/allowed-origins.tsx
@@ -0,0 +1,34 @@
+import type { AllowedOrigin } from '@spree/admin-sdk'
+import i18n from 'i18next'
+import { GlobeLockIcon } from 'lucide-react'
+import { RelativeTime } from '@/components/spree/relative-time'
+import { ResourceNameCell } from '@/components/spree/resource-name-cell'
+import { defineTable } from '@/lib/table-registry'
+
+defineTable<AllowedOrigin>('allowed-origins', {
+ title: i18n.t('admin.allowed_origins.table_title'),
+ searchParam: 'origin_cont',
+ searchPlaceholder: i18n.t('admin.allowed_origins.search_placeholder'),
+ defaultSort: { field: 'origin', direction: 'asc' },
+ emptyIcon: <GlobeLockIcon className="size-8 text-muted-foreground" />,
+ emptyMessage: i18n.t('admin.allowed_origins.empty'),
+ columns: [
+ {
+ key: 'origin',
+ label: i18n.t('admin.fields.allowed_origin.origin.label'),
+ sortable: true,
+ filterable: true,
+ default: true,
+ render: (origin) => (
+ <ResourceNameCell id={origin.id} dataAttr="data-allowed-origin-id" name={origin.origin} />
+ ),
+ },
+ {
+ key: 'created_at',
+ label: i18n.t('admin.fields.created_at.label'),
+ sortable: true,
+ default: true,
+ render: (origin) => <RelativeTime iso={origin.created_at} />,
+ },
+ ],
+})
diff --git a/packages/admin/src/tables/customers.tsx b/packages/admin/src/tables/customers.tsx
index c437d50eeb..e5e9fdf075 100644
--- a/packages/admin/src/tables/customers.tsx
+++ b/packages/admin/src/tables/customers.tsx
@@ -1,4 +1,5 @@
import { Link } from '@tanstack/react-router'
+import i18n from 'i18next'
import { UsersIcon } from 'lucide-react'
import { RelativeTime } from '@/components/spree/relative-time'
import { TagList } from '@/components/spree/tag-list'
@@ -113,7 +114,7 @@ defineTable('customers', {
},
{
key: 'created_at',
- label: 'Created',
+ label: i18n.t('admin.fields.created_at.label'),
sortable: true,
default: false,
filterType: 'date',
diff --git a/packages/admin/src/tables/gift-cards.tsx b/packages/admin/src/tables/gift-cards.tsx
index 3f6bb5f1aa..2ee3b49836 100644
--- a/packages/admin/src/tables/gift-cards.tsx
+++ b/packages/admin/src/tables/gift-cards.tsx
@@ -161,7 +161,7 @@ defineTable<GiftCard>('gift-cards', {
},
{
key: 'created_at',
- label: i18n.t('admin.gift_cards.columns.created'),
+ label: i18n.t('admin.fields.created_at.label'),
sortable: true,
filterType: 'date',
default: false,
diff --git a/packages/admin/src/tables/orders.tsx b/packages/admin/src/tables/orders.tsx
index 248962014f..ff618671d6 100644
--- a/packages/admin/src/tables/orders.tsx
+++ b/packages/admin/src/tables/orders.tsx
@@ -1,4 +1,5 @@
import { Link } from '@tanstack/react-router'
+import i18n from 'i18next'
import { ShoppingCartIcon } from 'lucide-react'
import { RelativeTime } from '@/components/spree/relative-time'
import { TagList } from '@/components/spree/tag-list'
@@ -139,7 +140,7 @@ defineTable('orders', {
},
{
key: 'created_at',
- label: 'Created at',
+ label: i18n.t('admin.fields.created_at.label'),
sortable: true,
default: false,
filterType: 'date',
diff --git a/packages/admin/src/tables/stock-transfers.tsx b/packages/admin/src/tables/stock-transfers.tsx
index 2045006e23..250c2a92b6 100644
--- a/packages/admin/src/tables/stock-transfers.tsx
+++ b/packages/admin/src/tables/stock-transfers.tsx
@@ -1,4 +1,5 @@
import type { StockTransfer } from '@spree/admin-sdk'
+import i18n from 'i18next'
import { ArrowLeftRightIcon } from 'lucide-react'
import { RelativeTime } from '@/components/spree/relative-time'
import { ResourceNameCell } from '@/components/spree/resource-name-cell'
@@ -48,7 +49,7 @@ defineTable<StockTransfer>('stock-transfers', {
},
{
key: 'created_at',
- label: 'Date',
+ label: i18n.t('admin.fields.created_at.label'),
sortable: true,
default: true,
filterType: 'date',
diff --git a/spree/api/app/controllers/spree/api/v3/admin/allowed_origins_controller.rb b/spree/api/app/controllers/spree/api/v3/admin/allowed_origins_controller.rb
new file mode 100644
index 0000000000..0757abafe8
--- /dev/null
+++ b/spree/api/app/controllers/spree/api/v3/admin/allowed_origins_controller.rb
@@ -0,0 +1,25 @@
+module Spree
+ module Api
+ module V3
+ module Admin
+ class AllowedOriginsController < ResourceController
+ scoped_resource :settings
+
+ protected
+
+ def model_class
+ Spree::AllowedOrigin
+ end
+
+ def serializer_class
+ Spree.api.admin_allowed_origin_serializer
+ end
+
+ def permitted_params
+ params.permit(:origin)
+ end
+ end
+ end
+ end
+ end
+end
diff --git a/spree/api/app/serializers/spree/api/v3/admin/allowed_origin_serializer.rb b/spree/api/app/serializers/spree/api/v3/admin/allowed_origin_serializer.rb
index aed2acf731..7f903f292f 100644
--- a/spree/api/app/serializers/spree/api/v3/admin/allowed_origin_serializer.rb
+++ b/spree/api/app/serializers/spree/api/v3/admin/allowed_origin_serializer.rb
@@ -5,12 +5,15 @@ module Spree
module V3
module Admin
class AllowedOriginSerializer < V3::BaseSerializer
- typelize store_id: :string
+ typelize origin: :string,
+ store_id: :string
- attributes :id, :origin, created_at: :iso8601, updated_at: :iso8601
+ attributes :origin, created_at: :iso8601, updated_at: :iso8601
- attribute :store_id do |allowed_origin|
- allowed_origin.store&.prefixed_id
+ # All rows share `current_store` because `Spree::AllowedOrigin`
+ # is a `SingleStoreResource` — avoid the per-row association load.
+ attribute :store_id do |_allowed_origin|
+ current_store&.prefixed_id
end
end
end
diff --git a/spree/api/config/routes.rb b/spree/api/config/routes.rb
index a625332798..cf777f7b52 100644
--- a/spree/api/config/routes.rb
+++ b/spree/api/config/routes.rb
@@ -140,6 +140,7 @@ Spree::Core::Engine.add_routes do
patch :revoke
end
end
+ resources :allowed_origins
resources :roles, only: [:index, :show]
# Direct Uploads (Active Storage)
diff --git a/spree/api/lib/spree/api/dependencies.rb b/spree/api/lib/spree/api/dependencies.rb
index 6ff86ccfec..660fe0bd75 100644
--- a/spree/api/lib/spree/api/dependencies.rb
+++ b/spree/api/lib/spree/api/dependencies.rb
@@ -206,6 +206,7 @@ module Spree
admin_digital_link_serializer: 'Spree::Api::V3::Admin::DigitalLinkSerializer',
admin_store_serializer: 'Spree::Api::V3::Admin::StoreSerializer',
admin_api_key_serializer: 'Spree::Api::V3::Admin::ApiKeySerializer',
+ admin_allowed_origin_serializer: 'Spree::Api::V3::Admin::AllowedOriginSerializer',
admin_invitation_serializer: 'Spree::Api::V3::Admin::InvitationSerializer',
admin_role_serializer: 'Spree::Api::V3::Admin::RoleSerializer',
admin_export_serializer: 'Spree::Api::V3::Admin::ExportSerializer',
diff --git a/spree/api/spec/integration/spree/api/v3/admin/allowed_origins_spec.rb b/spree/api/spec/integration/spree/api/v3/admin/allowed_origins_spec.rb
new file mode 100644
index 0000000000..92f7ad559c
--- /dev/null
+++ b/spree/api/spec/integration/spree/api/v3/admin/allowed_origins_spec.rb
@@ -0,0 +1,217 @@
+# frozen_string_literal: true
+
+require 'swagger_helper'
+
+RSpec.describe 'Admin Allowed Origins API', type: :request, swagger_doc: 'api-reference/admin.yaml' do
+ include_context 'API v3 Admin'
+
+ let!(:allowed_origin) { create(:allowed_origin, store: store, origin: 'https://shop.example.com') }
+ let(:Authorization) { "Bearer #{admin_jwt_token}" }
+
+ path '/api/v3/admin/allowed_origins' do
+ get 'List allowed origins' do
+ tags 'Configuration'
+ produces 'application/json'
+ security [api_key: [], bearer_auth: []]
+ description <<~DESC
+ Returns the CORS allowlist for the current store. Each entry is a
+ bare `scheme://host[:port]` permitted to call the admin API from a
+ browser. Backs the `Rack::Cors` allowlist and the CSRF boundary of
+ the admin cookie session (see
+ `docs/plans/5.5-admin-auth-cookie-refresh.md`).
+ DESC
+ admin_scope :read, :settings
+
+ admin_sdk_example 'allowed-origins/list'
+
+ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true
+ parameter name: :Authorization, in: :header, type: :string, required: true,
+ description: 'Bearer token for admin authentication'
+ parameter name: :page, in: :query, type: :integer, required: false, description: 'Page number'
+ parameter name: :limit, in: :query, type: :integer, required: false, description: 'Number of records per page'
+ parameter name: :'q[origin_cont]', in: :query, type: :string, required: false,
+ description: 'Filter by origin (contains)'
+ parameter name: :sort, in: :query, type: :string, required: false,
+ description: 'Sort by field. Prefix with `-` for descending (e.g., `-created_at`).'
+ parameter name: :fields, in: :query, type: :string, required: false,
+ description: 'Comma-separated list of fields to include. id is always included.'
+
+ response '200', 'allowed origins found' do
+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }
+
+ schema SwaggerSchemaHelpers.paginated('AllowedOrigin')
+
+ run_test! do |response|
+ data = JSON.parse(response.body)
+ expect(data['data']).to be_an(Array)
+ expect(data['data'].map { |o| o['id'] }).to include(allowed_origin.prefixed_id)
+ end
+ end
+
+ response '401', 'unauthorized' do
+ let(:'x-spree-api-key') { 'invalid' }
+ let(:Authorization) { 'Bearer invalid' }
+
+ schema '$ref' => '#/components/schemas/ErrorResponse'
+
+ run_test!
+ end
+ end
+
+ post 'Create an allowed origin' do
+ tags 'Configuration'
+ consumes 'application/json'
+ produces 'application/json'
+ security [api_key: [], bearer_auth: []]
+ description <<~DESC
+ Adds an origin to the admin CORS allowlist. The value must be a bare
+ `scheme://host[:port]` (no path, query, or fragment) and use `http` or
+ `https`.
+ DESC
+ admin_scope :write, :settings
+
+ admin_sdk_example 'allowed-origins/create'
+
+ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true
+ parameter name: :Authorization, in: :header, type: :string, required: true,
+ description: 'Bearer token for admin authentication'
+ parameter name: :body, in: :body, schema: {
+ type: :object,
+ properties: {
+ origin: { type: :string, example: 'https://admin.example.com' }
+ },
+ required: %w[origin]
+ }
+
+ response '201', 'allowed origin created' do
+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }
+ let(:body) { { origin: 'https://admin.example.com' } }
+
+ schema '$ref' => '#/components/schemas/AllowedOrigin'
+
+ run_test! do |response|
+ data = JSON.parse(response.body)
+ expect(data['origin']).to eq('https://admin.example.com')
+ end
+ end
+
+ response '422', 'validation error' do
+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }
+ let(:body) { { origin: 'not a url' } }
+
+ schema '$ref' => '#/components/schemas/ErrorResponse'
+
+ run_test!
+ end
+ end
+ end
+
+ path '/api/v3/admin/allowed_origins/{id}' do
+ parameter name: :id, in: :path, type: :string, required: true, description: 'Allowed origin ID'
+
+ get 'Get an allowed origin' do
+ tags 'Configuration'
+ produces 'application/json'
+ security [api_key: [], bearer_auth: []]
+ description 'Returns a single allowed origin by prefixed ID.'
+ admin_scope :read, :settings
+
+ admin_sdk_example 'allowed-origins/get'
+
+ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true
+ parameter name: :Authorization, in: :header, type: :string, required: true,
+ description: 'Bearer token for admin authentication'
+ parameter name: :fields, in: :query, type: :string, required: false,
+ description: 'Comma-separated list of fields to include. id is always included.'
+
+ response '200', 'allowed origin found' do
+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }
+ let(:id) { allowed_origin.prefixed_id }
+
+ schema '$ref' => '#/components/schemas/AllowedOrigin'
+
+ run_test! do |response|
+ data = JSON.parse(response.body)
+ expect(data['id']).to eq(allowed_origin.prefixed_id)
+ end
+ end
+
+ response '404', 'allowed origin not found' do
+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }
+ let(:id) { 'ao_nonexistent' }
+
+ schema '$ref' => '#/components/schemas/ErrorResponse'
+
+ run_test!
+ end
+ end
+
+ patch 'Update an allowed origin' do
+ tags 'Configuration'
+ consumes 'application/json'
+ produces 'application/json'
+ security [api_key: [], bearer_auth: []]
+ description 'Updates an existing allowed origin.'
+ admin_scope :write, :settings
+
+ admin_sdk_example 'allowed-origins/update'
+
+ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true
+ parameter name: :Authorization, in: :header, type: :string, required: true,
+ description: 'Bearer token for admin authentication'
+ parameter name: :body, in: :body, schema: {
+ type: :object,
+ properties: {
+ origin: { type: :string }
+ }
+ }
+
+ response '200', 'allowed origin updated' do
+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }
+ let(:id) { allowed_origin.prefixed_id }
+ let(:body) { { origin: 'https://www.example.com' } }
+
+ schema '$ref' => '#/components/schemas/AllowedOrigin'
+
+ run_test! do |response|
+ data = JSON.parse(response.body)
+ expect(data['origin']).to eq('https://www.example.com')
+ end
+ end
+
+ response '422', 'validation error' do
+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }
+ let(:id) { allowed_origin.prefixed_id }
+ let(:body) { { origin: 'https://example.com/with-path' } }
+
+ schema '$ref' => '#/components/schemas/ErrorResponse'
+
+ run_test!
+ end
+ end
+
+ delete 'Delete an allowed origin' do
+ tags 'Configuration'
+ security [api_key: [], bearer_auth: []]
+ description <<~DESC
+ Removes an origin from the admin CORS allowlist. After deletion the
+ admin SPA running at that origin will no longer be able to call the
+ admin API from a browser.
+ DESC
+ admin_scope :write, :settings
+
+ admin_sdk_example 'allowed-origins/delete'
+
+ parameter name: 'x-spree-api-key', in: :header, type: :string, required: true
+ parameter name: :Authorization, in: :header, type: :string, required: true,
+ description: 'Bearer token for admin authentication'
+
+ response '204', 'allowed origin deleted' do
+ let(:'x-spree-api-key') { secret_api_key.plaintext_token }
+ let(:id) { allowed_origin.prefixed_id }
+
+ run_test!
+ end
+ end
+ end
+end
diff --git a/spree/core/app/models/spree/permission_sets/configuration_management.rb b/spree/core/app/models/spree/permission_sets/configuration_management.rb
index 67a7998462..babf1f9d7f 100644
--- a/spree/core/app/models/spree/permission_sets/configuration_management.rb
+++ b/spree/core/app/models/spree/permission_sets/configuration_management.rb
@@ -32,6 +32,10 @@ module Spree
can :manage, Spree::TaxCategory
can :manage, Spree::TaxRate
+ # CORS allowlist used by Rack::Cors + admin cookie auth (see
+ # docs/plans/5.5-admin-auth-cookie-refresh.md).
+ can :manage, Spree::AllowedOrigin
+
# General configuration
can :manage, Spree::RefundReason
can :manage, Spree::ReimbursementType