# Acme Store API

> Manage products, orders and customers of an Acme storefront.

This is the documentation of the API, including a reference generated from a Yaak workspace. Every page is available as Markdown by appending `.md` to its URL.

## Guides › Getting started

- [Introduction](/editorial/index.md): Everything you need to build on the Acme Store API.
- [Quickstart](/editorial/quickstart.md): Make your first request in under a minute.

## Guides › Guides

- [Authentication](/editorial/guides/authentication.md): Get an access token and keep it fresh.
- [Pagination](/editorial/guides/pagination.md): Page through long lists with page and limit.

## Changelog

- [Changelog](/editorial/changelog.md): Notable changes to the Acme Store API.

## Endpoints

- [Health check](/editorial/reference/health-check.md): Returns ok when the API is up.

## Authentication

Obtain and refresh access tokens.

- [Authentication overview](/editorial/reference/authentication.md)
- [Log in](/editorial/reference/authentication/log-in.md): Exchange user credentials for an access token.
- [Refresh token](/editorial/reference/authentication/refresh-token.md): Get a new access token using a refresh token (OAuth 2 style form body).

## Products

Products are the items sold in your store.

- [Products overview](/editorial/reference/products.md)
- [List products](/editorial/reference/products/list-products.md): Returns a paginated list of products, newest first.
- [Get a product](/editorial/reference/products/get-a-product.md): Retrieve a single product by its id.
- [Create a product](/editorial/reference/products/create-a-product.md): Create a new product.
- [Update a product](/editorial/reference/products/update-a-product.md): Partially update a product.
- [Delete a product](/editorial/reference/products/delete-a-product.md): Permanently delete a product.
- [Images](/editorial/reference/products/images.md): Upload and manage product images.
  - [Upload an image](/editorial/reference/products/images/upload-an-image.md): Upload a product image (PNG or JPEG, max 5 MB).

## Catalog

Browse the product catalog by category.

- [Catalog overview](/editorial/reference/catalog.md)
- [Categories](/editorial/reference/catalog/categories.md): Top-level product categories.
  - [List categories](/editorial/reference/catalog/categories/list-categories.md): Returns all top-level categories.
  - [Subcategories](/editorial/reference/catalog/categories/subcategories.md): Categories within a category.
    - [List subcategories](/editorial/reference/catalog/categories/subcategories/list-subcategories.md): Returns the subcategories of a category.
    - [Attributes](/editorial/reference/catalog/categories/subcategories/attributes.md): Filterable attributes of a subcategory (size, color, …).
      - [List attribute values](/editorial/reference/catalog/categories/subcategories/attributes/list-attribute-values.md): Returns the values of every filterable attribute in a subcategory.

## Orders

Orders placed by customers.

- [Orders overview](/editorial/reference/orders.md)
- [List orders](/editorial/reference/orders/list-orders.md): List orders, optionally filtered by status.
- [Create an order](/editorial/reference/orders/create-an-order.md): Place an order on behalf of a customer.
- [Export orders (XML)](/editorial/reference/orders/export-orders-xml.md): Legacy XML export.

## GraphQL

A GraphQL endpoint is available for flexible queries.

- [GraphQL overview](/editorial/reference/graphql.md)
- [Search products](/editorial/reference/graphql/search-products.md): Full-text product search with GraphQL.

## Realtime

Streaming APIs over WebSockets and gRPC.

- [Realtime overview](/editorial/reference/realtime.md)
- [Order updates](/editorial/reference/realtime/order-updates.md): Subscribe to real-time order events.
- [Get stock level](/editorial/reference/realtime/get-stock-level.md): Query live inventory via gRPC.

## Optional

- [Full documentation](/editorial/llms-full.txt): All endpoints in a single file