Admin API 2026-01 · App Bridge v1

Build apps for the desktop where COD sellers work.

Ostorya merchants run their shop from a desktop in the browser. Your app opens from its dock, in an iframe, and works on their products, orders, customers and deliveries through 138 GraphQL operations.

Build an app API reference

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

const bridge = createAppBridge("https://ostorya.com", {
  theme: (t) => applyTheme(t.appearance, t.accent),
});

bridge.setTitle("Conversations");

const { orders } = await bridge.graphql(`{
  orders(first: 20, query: "status:open") {
    nodes { id name customer { displayName phone } }
  }
}`);

bridge.notify(`${orders.nodes.length} orders to confirm`, orders.nodes.length);

Apps

Build an app

Your web app in the merchant's desktop, from the dock. Start here if you build WhatsApp, Ads Manager or Finder.

Apps

App Bridge

Tokens, theme, titles, toasts and dock badges between your iframe and the desktop.

Reference

Admin GraphQL API

Every query and mutation, generated from the live schema (2026-01).

Commerce

The COD order lifecycle

Placed, confirmed by phone, shipped, delivered or refused, and the cash back from the courier.

Getting started

Authentication and scopes

Access tokens, scopes, and how staff roles narrow them.

Storefronts

Storefronts and themes

Each shop's site on <handle>.ostorya.store, built from themes as data.

Apps in the dock, waiting for their developer

These apps are already in every merchant's dock with their permissions. They go live the moment their URL is registered.

Confirm orders and talk to customers.

read/write orders, read customers

Ads Manager

Meta ad campaigns from the catalog.

read products, read orders

Finder

Browse and organize products and files.

read/write products

Building one? Send your app's HTTPS URL to [email protected], then follow Build an app.