EasyStore MCP by usefulapi is an MCP server published by io.usefulapi, hosted at easystore.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 29 tools, including easystore_get_store, easystore_list_locations, easystore_list_products, easystore_get_product, easystore_list_product_variants.
Read EasyStore orders, products and customers; manage stock, fulfillments and customer records.
4,222 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
The store behind this access token: name, contact emails, easystore domain, plan, locale, country, time zone, currencies and locations. Needs no API access scope. GET /api/3.0/store.json.
No parameters.
{
"name": "easystore_get_store",
"title": "Get store",
"description": "The store behind this access token: name, contact emails, easystore domain, plan, locale, country, time zone, currencies and locations. Needs no API access scope. GET /api/3.0/store.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get store",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The store's stock and pickup locations (warehouses, outlets) with address, phone, is_primary and pickup settings. Use the ids for inventory levels. Needs read_locations. GET /api/3.0/locations.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| limit | integer | Results per page, 1-100 (default 25). |
{
"name": "easystore_list_locations",
"title": "List locations",
"description": "The store's stock and pickup locations (warehouses, outlets) with address, phone, is_primary and pickup settings. Use the ids for inventory levels. Needs read_locations. GET /api/3.0/locations.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List locations",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List products with variants, prices, SKUs, stock, images and collections. Filter by collection, SKU, published status or dates. Needs read_products. GET /api/3.0/products.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| skus | string | Only products with these SKUs, comma-separated. |
| sort | string | Sort as field.asc or field.desc, e.g. id.asc (a stable order for paging through everything). |
| limit | integer | Results per page, 1-100 (default 25). |
| since_id | integer | Start at this product id (inclusive: id >= since_id). |
| is_bundle | boolean | true = only bundle products, false = no bundle products. |
| visibility | string | Only published or only unpublished products. |
| collection_ids | string | Only products in these collection ids, comma-separated, e.g. 2311217,2311218. |
| created_at_max | string | yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone. |
| created_at_min |
One product by id with its variants, options, images and collections. Needs read_products. GET /api/3.0/products/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| product_id * | integer | EasyStore product id. |
{
"name": "easystore_get_product",
"title": "Get product",
"description": "One product by id with its variants, options, images and collections. Needs read_products. GET /api/3.0/products/{id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "EasyStore product id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get product",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The variants of one product (price, SKU, barcode, stock, weight, enabled flag). Needs read_products. GET /api/3.0/products/{id}/variants.json.
| Parameter | Type | Description |
|---|---|---|
| product_id * | integer | EasyStore product id. |
{
"name": "easystore_list_product_variants",
"title": "List product variants",
"description": "The variants of one product (price, SKU, barcode, stock, weight, enabled flag). Needs read_products. GET /api/3.0/products/{id}/variants.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "EasyStore product id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List product variants",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List product collections. Needs read_products. GET /api/3.0/collections.json.
| Parameter | Type | Description |
|---|---|---|
| ids | string | Only these collection ids, comma-separated. |
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| sort | string | Sort as field.asc or field.desc, e.g. id.asc (a stable order for paging through everything). |
| limit | integer | Results per page, 1-100 (default 25). |
| since_id | integer | Start at this collection id (inclusive). |
| visibility | boolean | true = only published collections. |
{
"name": "easystore_list_collections",
"title": "List collections",
"description": "List product collections. Needs read_products. GET /api/3.0/collections.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ids": {
"type": "string",
"pattern": "^\\d+(\\s*,\\s*\\d+)*$",
"description": "Only these collection ids, comma-separated."
},
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"sort": {
"type": "string",
"pattern": "^[a-z_]{1,40}\\.(asc|desc)$",
"description": "Sort as field.asc or field.desc, e.g. id.asc (a stable order for paging through everything)."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"since_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Start at this collection id (inclusive).",
"exclusiveMinimum": 0
},
"visibility": {
"type": "boolean",
"description": "true = only published collections."
}
}
},
"annotations": {
"title": "List collections",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One collection by id. Needs read_products. GET /api/3.0/collections/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| collection_id * | integer | EasyStore collection id. |
{
"name": "easystore_get_collection",
"title": "Get collection",
"description": "One collection by id. Needs read_products. GET /api/3.0/collections/{id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"collection_id"
],
"properties": {
"collection_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "EasyStore collection id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get collection",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Stock per variant per location: available (inventory_quantity), committed, incoming and reserved. Pass variant_ids or location_ids (at least one is required). Needs read_products. GET /api/4.0/inventory_levels.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| limit | integer | Results per page, 1-100 (default 25). |
| variant_ids | string | Variant ids, comma-separated (see easystore_list_product_variants). |
| location_ids | string | Location ids, comma-separated (see easystore_list_locations). |
{
"name": "easystore_list_inventory_levels",
"title": "List inventory levels",
"description": "Stock per variant per location: available (inventory_quantity), committed, incoming and reserved. Pass variant_ids or location_ids (at least one is required). Needs read_products. GET /api/4.0/inventory_levels.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"variant_ids": {
"type": "string",
"pattern": "^\\d+(\\s*,\\s*\\d+)*$",
"description": "Variant ids, comma-separated (see easystore_list_product_variants)."
},
"location_ids": {
"type": "string",
"pattern": "^\\d+(\\s*,\\s*\\d+)*$",
"description": "Location ids, comma-separated (see easystore_list_locations)."
}
}
},
"annotations": {
"title": "List inventory levels",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List orders from every sales channel with customer, items, totals, payment and fulfillment status. Filter by payment or fulfillment status, customer, or dates (store time zone). Needs read_orders. GET /api/3.0/orders.json.
| Parameter | Type | Description |
|---|---|---|
| ids | string | Only these order ids, comma-separated. |
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| sort | string | Sort as field.asc or field.desc, e.g. id.asc (a stable order for paging through everything). |
| limit | integer | Results per page, 1-100 (default 25). |
| since_id | integer | Start at this order id (inclusive: id >= since_id). Use with sort=id.asc. |
| customer_id | integer | Only this customer's orders. |
| created_at_max | string | yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone. |
| created_at_min | string | yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone. |
| updated_at_max | string | yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone. |
One order by id. Ask for extra sections with fields: items, addresses, transactions, fulfillments, refunds, taxes, customer, shipping_fees, discounts, points, cancellation, note_attributes. Needs read_orders. GET /api/3.0/orders/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| fields | string | Comma-separated extra sections, e.g. items,addresses,fulfillments. |
| order_id * | integer | EasyStore order id (not the order number). |
{
"name": "easystore_get_order",
"title": "Get order",
"description": "One order by id. Ask for extra sections with fields: items, addresses, transactions, fulfillments, refunds, taxes, customer, shipping_fees, discounts, points, cancellation, note_attributes. Needs read_orders. GET /api/3.0/orders/{id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"fields": {
"type": "string",
"pattern": "^[a-z_]+(\\s*,\\s*[a-z_]+)*$",
"description": "Comma-separated extra sections, e.g. items,addresses,fulfillments."
},
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "EasyStore order id (not the order number).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get order",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The fulfillments (shipments with tracking details and status) of one order. Needs read_fulfillments. GET /api/3.0/orders/{id}/fulfillments.json.
| Parameter | Type | Description |
|---|---|---|
| order_id * | integer | EasyStore order id. |
{
"name": "easystore_list_order_fulfillments",
"title": "List order fulfillments",
"description": "The fulfillments (shipments with tracking details and status) of one order. Needs read_fulfillments. GET /api/3.0/orders/{id}/fulfillments.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "EasyStore order id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List order fulfillments",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The payment transactions of one order (gateway, amount, status). Needs read_orders. GET /api/3.0/orders/{id}/transactions.json.
| Parameter | Type | Description |
|---|---|---|
| order_id * | integer | EasyStore order id. |
{
"name": "easystore_list_order_transactions",
"title": "List order transactions",
"description": "The payment transactions of one order (gateway, amount, status). Needs read_orders. GET /api/3.0/orders/{id}/transactions.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "EasyStore order id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List order transactions",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List checkouts (carts in progress or abandoned). Cart tokens are not returned. Needs read_orders. GET /api/3.0/checkouts.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| limit | integer | Results per page, 1-50 (default 25). |
| since_id | integer | Start at this checkout id (inclusive). |
{
"name": "easystore_list_checkouts",
"title": "List checkouts",
"description": "List checkouts (carts in progress or abandoned). Cart tokens are not returned. Needs read_orders. GET /api/3.0/checkouts.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 50,
"description": "Results per page, 1-50 (default 25).",
"exclusiveMinimum": 0
},
"since_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Start at this checkout id (inclusive).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List checkouts",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List customers with contact details, order count, total spent, groups and store credit. Search by name or email with query. Needs read_customers. GET /api/3.0/customers.json.
| Parameter | Type | Description |
|---|---|---|
| ids | string | Only these customer ids, comma-separated. |
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| sort | string | Sort as field.asc or field.desc, e.g. id.asc (a stable order for paging through everything). |
| limit | integer | Results per page, 1-100 (default 25). |
| query | string | Match on first name, last name or email. |
| since_id | integer | Start at this customer id (inclusive). |
| created_at_max | string | ISO 8601 date or date-time, e.g. 2026-10-01 or 2026-10-01T00:00:00+08:00. |
| created_at_min | string | ISO 8601 date or date-time, e.g. 2026-10-01 or 2026-10-01T00:00:00+08:00. |
| updated_at_max | string | ISO 8601 date or date-time, e.g. 2026-10-01 or 2026-10-01T00:00:00+08:00. |
| updated_at_min |
Find customers by exact email, phone number or customer code. Pass at least one. Needs read_customers. GET /api/3.0/customers/search.json.
| Parameter | Type | Description |
|---|---|---|
| code | string | Customer code. |
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| string | Exact email address. | |
| limit | integer | Results per page, 1-100 (default 25). |
| phone | string | Phone number as stored, e.g. 601110768827. |
{
"name": "easystore_search_customers",
"title": "Search customers",
"description": "Find customers by exact email, phone number or customer code. Pass at least one. Needs read_customers. GET /api/3.0/customers/search.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"code": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Customer code."
},
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"email": {
"type": "string",
"maxLength": 254,
"minLength": 3,
"description": "Exact email address."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"phone": {
"type": "string",
"maxLength": 40,
"minLength": 3,
"description": "Phone number as stored, e.g. 601110768827."
}
}
},
"annotations": {
"title": "Search customers",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One customer by id. Add fields=points,membership for loyalty data. Needs read_customers. GET /api/3.0/customers/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| fields | string | Extra sections, e.g. points,membership. |
| customer_id * | integer | EasyStore customer id. |
{
"name": "easystore_get_customer",
"title": "Get customer",
"description": "One customer by id. Add fields=points,membership for loyalty data. Needs read_customers. GET /api/3.0/customers/{id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"fields": {
"type": "string",
"pattern": "^[a-z_]+(\\s*,\\s*[a-z_]+)*$",
"description": "Extra sections, e.g. points,membership."
},
"customer_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "EasyStore customer id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get customer",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The saved addresses of one customer. Needs read_customers. GET /api/3.0/customers/{id}/addresses.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| limit | integer | Results per page, 1-100 (default 25). |
| customer_id * | integer | EasyStore customer id. |
{
"name": "easystore_list_customer_addresses",
"title": "List customer addresses",
"description": "The saved addresses of one customer. Needs read_customers. GET /api/3.0/customers/{id}/addresses.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"customer_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "EasyStore customer id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List customer addresses",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The loyalty points balance of one customer. Needs read_customers. GET /api/3.0/customers/{id}/points.json.
| Parameter | Type | Description |
|---|---|---|
| customer_id * | integer | EasyStore customer id. |
{
"name": "easystore_get_customer_points",
"title": "Get customer points",
"description": "The loyalty points balance of one customer. Needs read_customers. GET /api/3.0/customers/{id}/points.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"customer_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "EasyStore customer id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get customer points",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List customer groups (for example VIP). Needs read_customers. GET /api/3.0/groups.json.
No parameters.
{
"name": "easystore_list_customer_groups",
"title": "List customer groups",
"description": "List customer groups (for example VIP). Needs read_customers. GET /api/3.0/groups.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List customer groups",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the store's content pages. Needs read_content. GET /api/3.0/pages.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| limit | integer | Results per page, 1-100 (default 25). |
{
"name": "easystore_list_pages",
"title": "List pages",
"description": "List the store's content pages. Needs read_content. GET /api/3.0/pages.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List pages",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List the store's blogs. Needs read_content. GET /api/3.0/blogs.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| limit | integer | Results per page, 1-100 (default 25). |
| visibility | string | Only published or unpublished blogs. |
{
"name": "easystore_list_blogs",
"title": "List blogs",
"description": "List the store's blogs. Needs read_content. GET /api/3.0/blogs.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"visibility": {
"enum": [
"published",
"unpublished"
],
"type": "string",
"description": "Only published or unpublished blogs."
}
}
},
"annotations": {
"title": "List blogs",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List blog articles. Needs read_content. GET /api/3.0/articles.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| limit | integer | Results per page, 1-100 (default 25). |
| visibility | string | Only published or unpublished articles. |
{
"name": "easystore_list_articles",
"title": "List blog articles",
"description": "List blog articles. Needs read_content. GET /api/3.0/articles.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"visibility": {
"enum": [
"published",
"unpublished"
],
"type": "string",
"description": "Only published or unpublished articles."
}
}
},
"annotations": {
"title": "List blog articles",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE. Set the stock of one variant at one location to an exact number (quantity 0 or more). Omit location_id for the primary location. Overwrites the current quantity; use easystore_adjust_inventory_level for a relative change. Needs write_products. PUT /api/4.0/inventory_levels/set.json.
| Parameter | Type | Description |
|---|---|---|
| quantity * | integer | The exact available quantity to set. |
| variant_id * | integer | Variant id (see easystore_list_product_variants). |
| location_id | integer | Location id (see easystore_list_locations). Default: the primary location. |
{
"name": "easystore_set_inventory_level",
"title": "Set inventory level",
"description": "WRITE. Set the stock of one variant at one location to an exact number (quantity 0 or more). Omit location_id for the primary location. Overwrites the current quantity; use easystore_adjust_inventory_level for a relative change. Needs write_products. PUT /api/4.0/inventory_levels/set.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"variant_id",
"quantity"
],
"properties": {
"quantity": {
"type": "integer",
"maximum": 1000000000,
"minimum": 0,
"description": "The exact available quantity to set."
},
"variant_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Variant id (see easystore_list_product_variants).",
"exclusiveMinimum": 0
},
"location_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Location id (see easystore_list_locations). Default: the primary location.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Set inventory level",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE. Add to or remove from the stock of one variant at one location by a relative amount (positive adds, negative removes; 0 is rejected). Not idempotent: repeating it changes the stock again. Omit location_id for the primary location. Needs write_products. PUT /api/4.0/inventory_levels/adjust.json.
| Parameter | Type | Description |
|---|---|---|
| variant_id * | integer | Variant id (see easystore_list_product_variants). |
| location_id | integer | Location id (see easystore_list_locations). Default: the primary location. |
| adjustment_quantity * | integer | Relative change: 5 adds 5, -5 removes 5. |
{
"name": "easystore_adjust_inventory_level",
"title": "Adjust inventory level",
"description": "WRITE. Add to or remove from the stock of one variant at one location by a relative amount (positive adds, negative removes; 0 is rejected). Not idempotent: repeating it changes the stock again. Omit location_id for the primary location. Needs write_products. PUT /api/4.0/inventory_levels/adjust.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"variant_id",
"adjustment_quantity"
],
"properties": {
"variant_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Variant id (see easystore_list_product_variants).",
"exclusiveMinimum": 0
},
"location_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Location id (see easystore_list_locations). Default: the primary location.",
"exclusiveMinimum": 0
},
"adjustment_quantity": {
"type": "integer",
"maximum": 1000000000,
"minimum": -1000000000,
"description": "Relative change: 5 adds 5, -5 removes 5."
}
}
},
"annotations": {
"title": "Adjust inventory level",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE. Change one variant's price, compare-at price, cost price, SKU, barcode or enabled flag. Only the fields you pass change. To change stock use the inventory tools. Needs write_products. PUT /api/3.0/products/{product_id}/variants.json.
| Parameter | Type | Description |
|---|---|---|
| sku | string | SKU. |
| price | number | Selling price in the store's primary currency. |
| barcode | string | Barcode. |
| cost_price | number | Cost price. |
| is_enabled | boolean | Whether the variant can be sold. |
| product_id * | integer | The product the variant belongs to. |
| variant_id * | integer | Variant id. |
| compare_at_price | number | Original price shown struck through. |
{
"name": "easystore_update_variant",
"title": "Update variant",
"description": "WRITE. Change one variant's price, compare-at price, cost price, SKU, barcode or enabled flag. Only the fields you pass change. To change stock use the inventory tools. Needs write_products. PUT /api/3.0/products/{product_id}/variants.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_id",
"variant_id"
],
"properties": {
"sku": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "SKU."
},
"price": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Selling price in the store's primary currency."
},
"barcode": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Barcode."
},
"cost_price": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Cost price."
},
"is_enabled": {
"type": "boolean",
"description": "Whether the variant can be sold."
},
"product_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The product the variant belongs to.",
"exclusiveMinimum": 0
},
"variant_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Variant id.",
"exclusiveMinimum": 0
},
"compare_at_price": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Original price shown struck through."
}
}
},
"annotations": {
"title": "Update variant",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE, hard to undo. Cancel an order, with an optional reason. Confirm the order id and number with the user first. Needs write_orders. POST /api/3.0/orders/{id}/cancel.json.
| Parameter | Type | Description |
|---|---|---|
| reason | string | Why the order is cancelled, e.g. Damaged item. |
| order_id * | integer | EasyStore order id (not the order number). |
{
"name": "easystore_cancel_order",
"title": "Cancel order",
"description": "WRITE, hard to undo. Cancel an order, with an optional reason. Confirm the order id and number with the user first. Needs write_orders. POST /api/3.0/orders/{id}/cancel.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"reason": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Why the order is cancelled, e.g. Damaged item."
},
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "EasyStore order id (not the order number).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Cancel order",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE. Mark an order (or some of its line items) as shipped, with tracking details. Not idempotent: calling it twice creates two fulfillments. With notify_customer true the customer is emailed. Needs write_fulfillments. POST /api/3.0/orders/{id}/fulfillments.json.
| Parameter | Type | Description |
|---|---|---|
| status | string | Shipment status. |
| message | string | Note about this fulfillment. |
| order_id * | integer | EasyStore order id. |
| line_items | array | Only these line items and quantities; omit to fulfill the whole order. |
| tracking_url | string | Tracking page URL. |
| notify_customer | boolean | Email the customer (default false). |
| tracking_number | string | Tracking number. |
| tracking_company | string | Courier name, e.g. DHL. |
{
"name": "easystore_create_fulfillment",
"title": "Create fulfillment",
"description": "WRITE. Mark an order (or some of its line items) as shipped, with tracking details. Not idempotent: calling it twice creates two fulfillments. With notify_customer true the customer is emailed. Needs write_fulfillments. POST /api/3.0/orders/{id}/fulfillments.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"status": {
"enum": [
"label_printed",
"label_purchased",
"attempted_delivery",
"available_for_pickup",
"successful_pickup",
"pending_pickup",
"arrived_sorting_hub",
"pending",
"open",
"in_transit",
"out_for_delivery",
"delivered",
"failure",
"cancelled",
"fulfilled"
],
"type": "string",
"description": "Shipment status."
},
"message": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "Note about this fulfillment."
},
"order_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "EasyStore order id.",
"exclusiveMinimum": 0
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"quantity"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Order line item id.",
"exclusiveMinimum": 0
},
"quantity": {
"type": "integer",
"maximum": 1000000,
"exclusiveMinimum": 0
}
}
},
"maxItems": 200,
"minItems": 1,
"description": "Only these line items and quantities; omit to fulfill the whole order."
},
"tracking_url": {
"type": "string",
"format": "uri",
"maxLength": 2000,
"description": "Tracking page URL."
},
"notify_customer": {
"type": "boolean",
"description": "Email the customer (default false)."
},
"tracking_number": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Tracking number."
},
"tracking_company": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Courier name, e.g. DHL."
}
}
},
"annotations": {
"title": "Create fulfillment",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE. Create a customer. Pass at least one of first_name, last_name, email or phone. Not idempotent. Needs write_customers. POST /api/3.0/customers.json.
| Parameter | Type | Description |
|---|---|---|
| code | string | Your own customer code. |
| string | Email (unique per store). | |
| phone | string | Phone number, e.g. +60192233445. |
| gender | string | Gender. |
| groups | array | Group names to assign, e.g. ["VIP"]. |
| birthdate | string | yyyy-mm-dd. |
| last_name | string | Last name. |
| first_name | string | First name. |
| country_code | string | Two-letter country code, e.g. MY. |
{
"name": "easystore_create_customer",
"title": "Create customer",
"description": "WRITE. Create a customer. Pass at least one of first_name, last_name, email or phone. Not idempotent. Needs write_customers. POST /api/3.0/customers.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"code": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Your own customer code."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254,
"description": "Email (unique per store)."
},
"phone": {
"type": "string",
"maxLength": 40,
"minLength": 3,
"description": "Phone number, e.g. +60192233445."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Gender."
},
"groups": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 50,
"description": "Group names to assign, e.g. [\"VIP\"]."
},
"birthdate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "yyyy-mm-dd."
},
"last_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Last name."
},
"first_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "First name."
},
"country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Two-letter country code, e.g. MY."
}
}
},
"annotations": {
"title": "Create customer",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE. Change fields of an existing customer; only the fields you pass change. Needs write_customers. PUT /api/3.0/customers/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| code | string | Your own customer code. |
| string | Email (unique per store). | |
| phone | string | Phone number, e.g. +60192233445. |
| gender | string | Gender. |
| groups | array | Group names to assign, e.g. ["VIP"]. |
| birthdate | string | yyyy-mm-dd. |
| last_name | string | Last name. |
| first_name | string | First name. |
| customer_id * | integer | EasyStore customer id. |
| country_code | string | Two-letter country code, e.g. MY. |
Tools for EasyStore, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which orders are paid but not yet fulfilled?"; "How much stock do I have left of the red hoodie at each location?"; "Find the customer with email jane@example.com and show her recent orders.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes EasyStore data. Free plan: 50 tool calls per month. Run easystore_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run easystore_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run easystore_upgrade without a plan: it returns both plans, each with a payment link for the user to open. easystore_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| string |
| yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone. |
| updated_at_max | string | yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone. |
| updated_at_min | string | yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone. |
{
"name": "easystore_list_products",
"title": "List products",
"description": "List products with variants, prices, SKUs, stock, images and collections. Filter by collection, SKU, published status or dates. Needs read_products. GET /api/3.0/products.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"skus": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Only products with these SKUs, comma-separated."
},
"sort": {
"type": "string",
"pattern": "^[a-z_]{1,40}\\.(asc|desc)$",
"description": "Sort as field.asc or field.desc, e.g. id.asc (a stable order for paging through everything)."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"since_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Start at this product id (inclusive: id >= since_id).",
"exclusiveMinimum": 0
},
"is_bundle": {
"type": "boolean",
"description": "true = only bundle products, false = no bundle products."
},
"visibility": {
"enum": [
"published",
"unpublished"
],
"type": "string",
"description": "Only published or only unpublished products."
},
"collection_ids": {
"type": "string",
"pattern": "^\\d+(\\s*,\\s*\\d+)*$",
"description": "Only products in these collection ids, comma-separated, e.g. 2311217,2311218."
},
"created_at_max": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([ T]\\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone."
},
"created_at_min": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([ T]\\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone."
},
"updated_at_max": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([ T]\\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone."
},
"updated_at_min": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([ T]\\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone."
}
}
},
"annotations": {
"title": "List products",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| updated_at_min |
| string |
| yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone. |
| financial_status | string | Payment status. |
| processed_at_max | string | yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone. |
| processed_at_min | string | yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone. |
| fulfillment_status | string | Shipping status. |
{
"name": "easystore_list_orders",
"title": "List orders",
"description": "List orders from every sales channel with customer, items, totals, payment and fulfillment status. Filter by payment or fulfillment status, customer, or dates (store time zone). Needs read_orders. GET /api/3.0/orders.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ids": {
"type": "string",
"pattern": "^\\d+(\\s*,\\s*\\d+)*$",
"description": "Only these order ids, comma-separated."
},
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"sort": {
"type": "string",
"pattern": "^[a-z_]{1,40}\\.(asc|desc)$",
"description": "Sort as field.asc or field.desc, e.g. id.asc (a stable order for paging through everything)."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"since_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Start at this order id (inclusive: id >= since_id). Use with sort=id.asc.",
"exclusiveMinimum": 0
},
"customer_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this customer's orders.",
"exclusiveMinimum": 0
},
"created_at_max": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([ T]\\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone."
},
"created_at_min": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([ T]\\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone."
},
"updated_at_max": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([ T]\\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone."
},
"updated_at_min": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([ T]\\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone."
},
"financial_status": {
"enum": [
"paid",
"partially_paid",
"unpaid",
"cod"
],
"type": "string",
"description": "Payment status."
},
"processed_at_max": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([ T]\\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone."
},
"processed_at_min": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([ T]\\d{2}:\\d{2}(:\\d{2})?)?$",
"description": "yyyy-mm-dd or yyyy-mm-dd hh:mm:ss, read in the store's own time zone."
},
"fulfillment_status": {
"enum": [
"fulfilled",
"partially_fulfilled",
"unfulfilled"
],
"type": "string",
"description": "Shipping status."
}
}
},
"annotations": {
"title": "List orders",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| string |
| ISO 8601 date or date-time, e.g. 2026-10-01 or 2026-10-01T00:00:00+08:00. |
{
"name": "easystore_list_customers",
"title": "List customers",
"description": "List customers with contact details, order count, total spent, groups and store credit. Search by name or email with query. Needs read_customers. GET /api/3.0/customers.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ids": {
"type": "string",
"pattern": "^\\d+(\\s*,\\s*\\d+)*$",
"description": "Only these customer ids, comma-separated."
},
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"sort": {
"type": "string",
"pattern": "^[a-z_]{1,40}\\.(asc|desc)$",
"description": "Sort as field.asc or field.desc, e.g. id.asc (a stable order for paging through everything)."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 25).",
"exclusiveMinimum": 0
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Match on first name, last name or email."
},
"since_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Start at this customer id (inclusive).",
"exclusiveMinimum": 0
},
"created_at_max": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "ISO 8601 date or date-time, e.g. 2026-10-01 or 2026-10-01T00:00:00+08:00."
},
"created_at_min": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "ISO 8601 date or date-time, e.g. 2026-10-01 or 2026-10-01T00:00:00+08:00."
},
"updated_at_max": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "ISO 8601 date or date-time, e.g. 2026-10-01 or 2026-10-01T00:00:00+08:00."
},
"updated_at_min": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,9})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "ISO 8601 date or date-time, e.g. 2026-10-01 or 2026-10-01T00:00:00+08:00."
}
}
},
"annotations": {
"title": "List customers",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}{
"name": "easystore_update_customer",
"title": "Update customer",
"description": "WRITE. Change fields of an existing customer; only the fields you pass change. Needs write_customers. PUT /api/3.0/customers/{id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"customer_id"
],
"properties": {
"code": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Your own customer code."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254,
"description": "Email (unique per store)."
},
"phone": {
"type": "string",
"maxLength": 40,
"minLength": 3,
"description": "Phone number, e.g. +60192233445."
},
"gender": {
"enum": [
"male",
"female"
],
"type": "string",
"description": "Gender."
},
"groups": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 50,
"description": "Group names to assign, e.g. [\"VIP\"]."
},
"birthdate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "yyyy-mm-dd."
},
"last_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Last name."
},
"first_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "First name."
},
"customer_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "EasyStore customer id.",
"exclusiveMinimum": 0
},
"country_code": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "Two-letter country code, e.g. MY."
}
}
},
"annotations": {
"title": "Update customer",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}