Ostorya dev docs

2026-01

GraphQL Admin API reference

The Admin API is how apps read and change a shop: the catalog, cash-on-delivery orders, delivery and cash, customers, discounts, themes and the team. Ostorya's own Store uses nothing else.

43 queries95 mutations224 objects17 enums

Endpoint#

POST https://ostorya.com/api/admin/2026-01/graphql.json

Authenticate with the X-Ostorya-Access-Token header (how apps get one). Inside an app, App Bridge does it for you:

import { createAppBridge } from "https://dev.ostorya.com/app-bridge/v1.mjs";

const bridge = createAppBridge("https://ostorya.com");
const { products } = await bridge.graphql(`
  query {
    products(first: 10, query: "status:active") {
      nodes { id title handle }
    }
  }
`);

Browse by area#

Discounts

5 queries · 25 mutations · 89 types

Shipping and fulfillment

5 queries · 9 mutations · 24 types

Team and commissions

3 queries · 10 mutations · 23 types

Analytics

1 queries · 0 mutations · 5 types

Orders

4 queries · 14 mutations · 45 types

Customers

4 queries · 12 mutations · 33 types

Inventory

3 queries · 2 mutations · 19 types

Online store

4 queries · 6 mutations · 9 types

Files and media

2 queries · 6 mutations · 22 types

Products and collections

7 queries · 10 mutations · 39 types

Store properties

3 queries · 1 mutations · 10 types

Conventions#