Skip to main content
This guide walks you through making a Point of Sale app callable by Starcat. By the end, Starcat will be able to pull sales reports, check inventory, look up orders, and more — all through conversation.

​
Prerequisites

  • A POS app built on Stardeck with data you want to expose (products, orders, sales)
  • The app should be published to production or have a running sandbox

​
Step 1: Ask the Agent to Expose APIs

Open your POS app’s project chat and tell the agent what you want other apps to be able to do. You don’t need to specify routes, parameters, or technical details — the agent designs all of that. 
Set up APIs so Starcat can check sales, look up orders,
and see inventory levels
Or even simpler: 
Expose an API so agents can use this app
The agent creates the endpoints, picks the right routes and parameters, and adds documentation so other agents know how to call them. The platform automatically detects and publishes the new endpoints once they’re built.
Start with read-only access. You can ask the agent to add write endpoints later once you’re comfortable with the flow.

​
Step 2: Test from the Project Chat

Before involving other apps, you can test your new endpoints right from the project chat. The project agent can make cross-app calls to your own app’s API: 
Test the sales endpoint and show me what it returns

Call the inventory endpoint and check if the data looks right
This lets you verify everything works before opening it up to Starcat or other apps.

​
Step 3: Allow Agent Access

Go to your POS app’s Settings tab and open the Cross-App section, then turn on Allow agent access. This is all Starcat needs — it operates the app as itself, on your behalf, so it doesn’t require an app-to-app grant (those are only for apps calling each other in code). Once it’s on, choose which of your app’s environments the agent may call:
  • Sandbox or Preview — good while you’re still building and testing endpoints
  • Production — once your endpoints are stable and you want the agent to query live data
Start narrow (Sandbox/Preview) and add Production when you’re confident.

​
Step 4: Talk to Starcat

Open Starcat from your organization dashboard. You can now ask it to query your POS app: Check today’s sales:
“How much revenue did the POS app make today?”
Investigate inventory:
“What products in the POS app are running low on stock?”
Look up a specific order:
“Look up order ORD-2847 in the POS app”
Get a business summary:
“Give me a sales summary from the POS app for last week — total revenue, number of orders, and average order value”
Cross-reference with another app:
“Compare this week’s POS sales to last week’s, and if revenue dropped more than 10%, create a task in the project management app to investigate”
Starcat will discover the available endpoints, make the appropriate calls, and present the data back to you in the conversation.

​
Adding Write Access Later

Once you’re comfortable with read-only queries, you can let the agent change data too. Starcat can call any published endpoint, including writes — there’s no separate method grant to manage. You just need the write endpoints to exist, so ask the project agent to add them: 
Add endpoints so agents can also create orders and adjust inventory
Once they’re published, Starcat can do things like “Add 50 units of SKU-1234 to the POS inventory” or “Create a sample order to test the checkout flow.”
Write endpoints let the agent modify data. Keep Allow agent access restricted to Sandbox/Preview until you’re confident the endpoints have proper validation, then add Production.