> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waffo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Store Endpoints

> Create, update, and manage stores

Stores are the top-level entity for organizing products, orders, and checkout experiences. Each merchant can own up to **20 stores**, and each store has its own webhook, notification, and checkout theme settings.

## Store Status Values

| Status      | Description                                                                      |
| ----------- | -------------------------------------------------------------------------------- |
| `active`    | Store is live and operational                                                    |
| `inactive`  | Store is disabled by the merchant; data is preserved but checkout is unavailable |
| `suspended` | Store is suspended by the platform; merchant cannot reactivate                   |

## Role-Based Access Control

Each merchant in a store is assigned one of three roles. The store creator is automatically assigned `owner`.

| Permission            | `owner` | `admin` | `member` |
| --------------------- | ------- | ------- | -------- |
| Read store details    | Yes     | Yes     | Yes      |
| Update store settings | Yes     | Yes     | No       |
| Delete store          | Yes     | No      | No       |
| Create store          | --      | --      | --       |

<Note>
  Store creation is not role-gated -- any authenticated merchant can create a new store (up to the 20-store limit). Roles only apply to operations on existing stores.
</Note>

## Endpoints

<CardGroup cols={3}>
  <Card title="Create Store" icon="plus" href="/api-reference/endpoints/stores/create-store">
    Create a new store for the authenticated merchant.
  </Card>

  <Card title="Update Store" icon="pen" href="/api-reference/endpoints/stores/update-store">
    Update store name, status, or configuration settings.
  </Card>

  <Card title="Delete Store" icon="trash" href="/api-reference/endpoints/stores/delete-store">
    Soft-delete a store (owner only).
  </Card>
</CardGroup>