{ "opencollection": "1.0.0", "info": { "name": "Admin Account / Address Channels API", "version": "v3" }, "items": [ { "info": { "name": "Channels", "type": "folder" }, "items": [ { "info": { "name": "List channels", "type": "http" }, "http": { "method": "GET", "url": "http://{defaultHost}/api/v3/admin/channels", "headers": [ { "name": "x-spree-api-key", "value": "" }, { "name": "Authorization", "value": "" } ], "params": [ { "name": "page", "value": "", "type": "query" }, { "name": "limit", "value": "", "type": "query" } ], "auth": { "type": "apikey", "key": "x-spree-api-key", "value": "{{x-spree-api-key}}", "placement": "header" } }, "docs": "Returns the channels configured for the current store.\n\n**Required scope:** `read_settings` (for API-key authentication)." }, { "info": { "name": "Create a channel", "type": "http" }, "http": { "method": "POST", "url": "http://{defaultHost}/api/v3/admin/channels", "headers": [ { "name": "x-spree-api-key", "value": "" }, { "name": "Authorization", "value": "" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "x-spree-api-key", "value": "{{x-spree-api-key}}", "placement": "header" } }, "docs": "Creates a new channel on the current store. `code` is normalized to a\nURL-safe slug (`Point of Sale` → `point-of-sale`); when omitted it's\nderived from `name`.\n\n\n**Required scope:** `write_settings` (for API-key authentication)." }, { "info": { "name": "Get a channel", "type": "http" }, "http": { "method": "GET", "url": "http://{defaultHost}/api/v3/admin/channels/:id", "headers": [ { "name": "x-spree-api-key", "value": "" }, { "name": "Authorization", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ], "auth": { "type": "apikey", "key": "x-spree-api-key", "value": "{{x-spree-api-key}}", "placement": "header" } }, "docs": "**Required scope:** `read_settings` (for API-key authentication)." }, { "info": { "name": "Update a channel", "type": "http" }, "http": { "method": "PATCH", "url": "http://{defaultHost}/api/v3/admin/channels/:id", "headers": [ { "name": "x-spree-api-key", "value": "" }, { "name": "Authorization", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "x-spree-api-key", "value": "{{x-spree-api-key}}", "placement": "header" } }, "docs": "**Required scope:** `write_settings` (for API-key authentication)." }, { "info": { "name": "Delete a channel", "type": "http" }, "http": { "method": "DELETE", "url": "http://{defaultHost}/api/v3/admin/channels/:id", "headers": [ { "name": "x-spree-api-key", "value": "" }, { "name": "Authorization", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ], "auth": { "type": "apikey", "key": "x-spree-api-key", "value": "{{x-spree-api-key}}", "placement": "header" } }, "docs": "**Required scope:** `write_settings` (for API-key authentication)." }, { "info": { "name": "Publish products on a channel", "type": "http" }, "http": { "method": "POST", "url": "http://{defaultHost}/api/v3/admin/channels/:id/add_products", "headers": [ { "name": "x-spree-api-key", "value": "" }, { "name": "Authorization", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "x-spree-api-key", "value": "{{x-spree-api-key}}", "placement": "header" } }, "docs": "Publishes the listed products on this channel. Idempotent — re-publishing\nan already-published product updates its publication window. Products from\nsibling stores are silently dropped.\n\n\n**Required scope:** `write_products` (for API-key authentication)." }, { "info": { "name": "Unpublish products from a channel", "type": "http" }, "http": { "method": "POST", "url": "http://{defaultHost}/api/v3/admin/channels/:id/remove_products", "headers": [ { "name": "x-spree-api-key", "value": "" }, { "name": "Authorization", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" }, "auth": { "type": "apikey", "key": "x-spree-api-key", "value": "{{x-spree-api-key}}", "placement": "header" } }, "docs": "Unpublishes the listed products from this channel.\n\n**Required scope:** `write_products` (for API-key authentication)." } ] } ], "bundled": true }