{ "opencollection": "1.0.0", "info": { "name": "Admin Account / Address Settings API", "version": "v3" }, "items": [ { "info": { "name": "Settings", "type": "folder" }, "items": [ { "info": { "name": "List store credit categories", "type": "http" }, "http": { "method": "GET", "url": "http://{defaultHost}/api/v3/admin/store_credit_categories", "headers": [ { "name": "x-spree-api-key", "value": "" }, { "name": "Authorization", "value": "" } ], "params": [ { "name": "page", "value": "", "type": "query", "description": "Page number" }, { "name": "limit", "value": "", "type": "query", "description": "Number of records per page" }, { "name": "q[name_cont]", "value": "", "type": "query", "description": "Filter by name (contains)" }, { "name": "sort", "value": "", "type": "query", "description": "Sort by field. Prefix with `-` for descending (e.g., `-created_at`)." }, { "name": "fields", "value": "", "type": "query", "description": "Comma-separated list of fields to include. id is always included." } ], "auth": { "type": "apikey", "key": "x-spree-api-key", "value": "{{x-spree-api-key}}", "placement": "header" } }, "docs": "Returns the configured store credit categories. Categories classify\nstore credits (e.g., \"Goodwill\", \"Gift Card\", \"Refund\") and surface\nin the admin UI as a dropdown when issuing or editing a store\ncredit. Category names matching `Spree::Config[:non_expiring_credit_types]`\nare flagged via `non_expiring: true`.\n\n\n**Required scope:** `read_settings` (for API-key authentication)." }, { "info": { "name": "Get a store credit category", "type": "http" }, "http": { "method": "GET", "url": "http://{defaultHost}/api/v3/admin/store_credit_categories/:id", "headers": [ { "name": "x-spree-api-key", "value": "" }, { "name": "Authorization", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "Store credit category ID" }, { "name": "fields", "value": "", "type": "query", "description": "Comma-separated list of fields to include. id is always included." } ], "auth": { "type": "apikey", "key": "x-spree-api-key", "value": "{{x-spree-api-key}}", "placement": "header" } }, "docs": "Returns a single store credit category by prefixed ID.\n\n**Required scope:** `read_settings` (for API-key authentication)." }, { "info": { "name": "Get the current store", "type": "http" }, "http": { "method": "GET", "url": "http://{defaultHost}/api/v3/admin/store", "headers": [ { "name": "x-spree-api-key", "value": "" }, { "name": "Authorization", "value": "" } ], "auth": { "type": "apikey", "key": "x-spree-api-key", "value": "{{x-spree-api-key}}", "placement": "header" } }, "docs": "Returns the current store configuration. The store is resolved from the request context (host or admin selection); there is no `id` parameter.\n\n**Required scope:** `read_settings` (for API-key authentication)." }, { "info": { "name": "Update the current store", "type": "http" }, "http": { "method": "PATCH", "url": "http://{defaultHost}/api/v3/admin/store", "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": "Updates the current store configuration.\n\n**Required scope:** `write_settings` (for API-key authentication)." }, { "info": { "name": "List tags", "type": "http" }, "http": { "method": "GET", "url": "http://{defaultHost}/api/v3/admin/tags", "headers": [ { "name": "x-spree-api-key", "value": "" }, { "name": "Authorization", "value": "" } ], "params": [ { "name": "taggable_type", "value": "", "type": "query", "description": "Taggable type (`Spree::Product`, `Spree::Order`, or `Spree::User`)" }, { "name": "q", "value": "", "type": "query", "description": "Optional case-insensitive substring filter" } ], "auth": { "type": "apikey", "key": "x-spree-api-key", "value": "{{x-spree-api-key}}", "placement": "header" } }, "docs": "Returns tag names for a given taggable type. Used for autocomplete in tag inputs on products, orders, and customers." } ] } ], "bundled": true }