Skip to main content

GraphQL API

Everything Kadaikodi can do is available through a single GraphQL API on the Burdenoff Workspaces platform. Every operation is authenticated and permission-checked against the calling actor's role in the workspace.

Endpoint​

Production:

https://graphqlworkspaces.burdenoff.com/workspaces/graphql

See Environment Selection for alpha and local endpoints.

Auth headers​

Authorization: Bearer <token>
x-workspace-id: <workspace-uuid>

x-workspace-id is required. Kadaikodi data is workspace-scoped.

Key types (Kadaikodi-specific)​

TypeWhat
ServiceProviderMerchant — name, category, status, rating, location
OfferingProduct or service — price, stock, media, fulfillment types
CartDurable working set of items with computed totals
Order / OrderItemTransaction with status and payment status
WorkerFulfillment roster member
WorkerTaskDiscrete job assigned to a worker
ReviewCustomer feedback with rating and response
InvestmentOpportunityMerchant funding round
InvestmentBacker's capital commitment
KadaikodiDashboardStatsWorkspace-level KPIs

Example queries​

query ListProviders {
  listServiceProviders {
    id
    name
    category
    status
    rating
  }
}

query ProviderWithOfferings($providerId: ID!) {
  serviceProvider(id: $providerId) {
    id
    name
    offerings {
      id
      name
      price
      stock
      available
    }
  }
}

Example mutations​

mutation CreateOffering {
  createOffering(input: {
    name: "Cold Brew Coffee"
    category: FOOD_AND_BEVERAGE
    price: 180.00
    stock: 40
    fulfillmentTypes: [PICKUP, DELIVERY]
  }) { id }
}

mutation PlaceOrder {
  placeOrder(input: {
    items: [{ offeringId: "off_123", quantity: 2 }]
    fulfillmentType: DELIVERY
    paymentMethod: UPI
  }) {
    id
    orderNumber
    status
    total
  }
}

mutation UpdateOrderStatus {
  updateOrderStatus(id: "ord_789", status: PREPARING) {
    id
    orderNumber
    status
  }
}

Analytics​

query Dashboard {
  kadaikodiDashboardStats {
    totalOrders
    totalRevenue
    activeMerchants
    activeCustomers
    averageRating
    pendingOrders
  }
}

query AdminAnalytics {
  kadaikodiAdminAnalytics {
    revenueByCategory { category revenue }
    orderTrends { date count }
    topMerchants { merchantId revenue }
    customerGrowth { date count }
  }
}

Discover the live schema​

Introspection is disabled on the public endpoint. The authoritative schema is published in the Burdenoff Workspaces developer docs.

Next steps​