Dedicated ShopOS App
What This App Is
ShopOS Manager Assistant is the org-scoped companion to the FlatRate Pro technician assistant. It is designed for ShopOS admins who need organization health, technician roster visibility, and filtered queue lookup in ChatGPT or other OpenAI-compatible Actions clients.
This first version is intentionally read-focused. Verification actions, workflow changes, billing, and invite management stay inside ShopOS until a separate write-safe app surface is approved.
1) Create An Org Token
- Open /connect-org-gpt.html.
- Sign in as a ShopOS owner, admin, or manager.
- Select an organization that has active ShopOS API access or an approved platform override.
- Create a token. The page now requests read-focused scopes only: read and org:read.
- Copy the token immediately. The raw token is only shown once.
Security Notes
- Tokens are scoped to a specific organization.
- Tokens are stored hashed server-side and can be revoked from the same page.
- Do not share org tokens outside trusted admin tools or secured internal AI clients.
2) OpenAI App Setup
Import the dedicated ShopOS schema, not the FlatRate Pro technician schema.
| Setting | Value |
|---|---|
| OpenAPI URL | https://geargenius.ai/.well-known/shopos-org-openapi.json |
| Manifest URL | https://geargenius.ai/.well-known/shopos-org-connector-manifest.json |
| Authentication | API Key → Custom header |
| Header Name | X-User-Token |
Recommended System Instructions
1. Start with
/api/shopos-org/stats to understand the org before answering.
2. Use /api/shopos-org/technicians when the manager asks about team members or staffing context.
3. Use /api/shopos-org/jobs/search for queue, technician, or date-range questions.
4. Keep the assistant read-focused. Do not claim to approve, reject, assign, bill, or mutate workflow through this app.
5. If a manager wants to take action, direct them back to ShopOS.
3) Supported Endpoints
| Endpoint | Method | Use |
|---|---|---|
/api/shopos-org/health |
GET | Health and auth status check |
/api/shopos-org/stats |
GET | Org summary, member counts, and queue totals |
/api/shopos-org/technicians |
GET | Technician roster with optional job counts |
/api/shopos-org/jobs/search |
POST | Search jobs by technician, status, and time window |
4) Quick Smoke Commands
# Health
curl -sS https://geargenius.ai/api/shopos-org/health | jq
# Org stats
curl -sS -H "X-User-Token: TOKEN" \
https://geargenius.ai/api/shopos-org/stats | jq
# Technician roster
curl -sS -H "X-User-Token: TOKEN" \
"https://geargenius.ai/api/shopos-org/technicians?includeStats=true" | jq
# Filtered job search
curl -sS -H "Content-Type: application/json" -H "X-User-Token: TOKEN" \
-d '{"range":"week","status":"pending","limit":10}' \
https://geargenius.ai/api/shopos-org/jobs/search | jq