# tyga.run SDK API

> The agent-first SaaS factory. 48 SDK modules, 4,627 endpoints, 453 sub-modules. Your coding agents build, operate, and scale any SaaS. One API key.

## Quick Reference — What Can I Do?

| I want to... | Endpoint | Auth required? |
|--------------|----------|---------------|
| Sign up (get API key) | POST /api/signup | No |
| Register an agent | POST /auth/agent-signup | Yes (SaaS key) |
| Who am I? | GET /api/tenant/me | Yes |
| Session summary | GET /api/dashboard | Yes |
| Skill file | GET /api/docs/skill.md | Yes |
| OpenAPI spec | GET /api/docs/openapi.json | Yes |
| Create a SaaS | POST /saas/provision | Yes |
| Sign up a user | POST /auth/signup | Yes |
| Create a subscription | POST /billing/subscriptions | Yes |
| Book a meeting | POST /scheduling/bookings | Yes |
| Create a support ticket | POST /support/tickets | Yes |
| Add a CRM lead | POST /crm/leads | Yes |
| Create a product | POST /ecommerce/products | Yes |
| Send a notification | POST /notifications/notifications | Yes |
| Check platform health | GET /health | No |
| Browse API docs | GET /docs | No |

## Agent Onboarding (3 Steps)

1. POST /api/signup {"slug":"my-saas","name":"My SaaS","email":"me@example.com"} → get API key (no auth)
2. GET /api/tenant/me → who am I, what plan, what modules
3. GET /api/dashboard → platform status, then start calling modules

## Authentication

Bearer token: `Authorization: Bearer YOUR_API_KEY`
Get an API key: `curl -X POST https://sdk.tyga.run/api/signup -d '{"slug":"my-saas","name":"My SaaS"}'`

## SaaS Provisioning (Dynamic)

- POST /saas/provision — Create full SaaS in one call (record + API key + plan + community + flat file)
- POST /saas/create — Create SaaS record only
- GET /saas/get?saasId=:id — Get SaaS details
- PATCH /saas/update/:id — Update SaaS config
- GET /saas/list — List all SaaS instances

## Identity & Access (auth)

- POST /auth/signup — Create user (auto-creates org, workspace, team member, website, subscription)
- POST /auth/signin — Sign in, returns JWT
- POST /auth/mfa/setup — Enable MFA (TOTP)
- POST /auth/mfa/verify — Verify MFA code
- PUT /auth/change-password — Change password
- GET /auth/user-profile — Get user profile
- PUT /auth/user-profile — Update profile

## API Key Management (apikeys)

- POST /apikeys/management — Create API key
- GET /apikeys/management — List API keys
- DELETE /apikeys/management/:keyId — Revoke key
- GET /apikeys/usage — Usage statistics
- POST /apikeys/cache/clear — Clear API key cache

## Billing & Payments (billing)

- POST /billing/subscriptions — Create subscription
- GET /billing/subscriptions — List subscriptions
- POST /billing/invoices — Create invoice
- GET /billing/invoices — List invoices
- POST /billing/payments/stripe — Process Stripe payment
- POST /billing/refunds — Process refund
- GET /billing/payouts — List payouts
- POST /billing/coupons — Create coupon
- GET /billing/subscription-plans — List plans
- POST /billing/subscription-plans — Create plan

## Scheduling (scheduling)

- POST /scheduling/event-types — Create event type
- GET /scheduling/event-types — List event types
- POST /scheduling/bookings — Create booking
- GET /scheduling/bookings — List bookings
- POST /scheduling/meetings — Create meeting
- GET /scheduling/availability — Get availability
- POST /scheduling/calendar-integrations — Add calendar (Google, Microsoft, CalDAV)

## CRM & Sales (crm)

- POST /crm/leads — Create lead
- GET /crm/leads — List leads
- POST /crm/opportunities — Create opportunity
- POST /crm/pipelines — Create pipeline
- POST /crm/campaigns — Create campaign
- POST /crm/referrals — Create referral
- GET /crm/agents — List sales agents

## Support & Helpdesk (support)

- POST /support/tickets — Create ticket
- GET /support/tickets — List tickets
- POST /support/live-chat — Start live chat
- GET /support/knowledgebase — Search knowledge base
- POST /support/canned-messages — Create canned message
- GET /support/agents — List support agents

## E-Commerce (ecommerce)

- POST /ecommerce/products — Create product
- GET /ecommerce/products — List products
- POST /ecommerce/orders — Create order
- POST /ecommerce/carts — Create cart
- POST /ecommerce/checkout — Process checkout
- POST /ecommerce/collections — Create collection
- POST /ecommerce/discounts — Create discount
- GET /ecommerce/inventory — Check inventory

## Teams & Organizations (teams)

- POST /teams/organizations — Create organization
- POST /teams/workspaces — Create workspace
- POST /teams/team-members — Add team member
- POST /teams/team-invitations — Send invitation
- GET /teams/cross-org — List cross-org members

## Website & Content (website)

- POST /website/websites — Create website
- POST /website/pages — Create page
- POST /website/blogs — Create blog post
- GET /website/templates — List templates
- GET /website/themes — List themes

## Community (community)

- POST /community/communities — Create community
- POST /community/posts — Create post
- POST /community/comments — Add comment
- GET /community/feed — Get feed

## AI & Agents (ai)

- POST /ai/conversations — Start AI conversation
- POST /ai/agent-registry — Register agent
- GET /ai/knowledge — Search knowledge base
- POST /ai/mcp-servers — Register MCP server
- GET /ai/analytics — AI usage analytics

## Compliance (compliance)

- GET /compliance/cookie-consent — Get consent records
- POST /compliance/data-subject-requests — Create DSR
- GET /compliance/reports — Compliance reports

## Telecom (mvno, icuk, broadband)

- POST /mvno/organizations — Create MVNO org
- POST /mvno/sims — Activate SIM
- POST /mvno/radius-accounts — Create RADIUS account
- GET /broadband/availability — Check broadband availability
- POST /broadband/provisioning — Provision broadband

## Webhooks

- POST /webhooks/generic — Register webhook
- GET /webhooks/logs — Webhook delivery logs

## All 48 Modules

auth, apikeys, teams, saas, billing, accounting, open-banking, crm, contracts, recruitment, scheduling, ecommerce, marketplace, event-ticketing, channels, notifications, email, community, support, website, news-publishing, elearning, surveys, compliance, hmrc, companieshouse, ai, analytics, gamification, widgets, datagrab, appdeploy, file-management, webhooks, map, postcode, domains, hosting, icuk, mvno, broadband, broadbandprovisioning, isp, ispreseller, esports, fitness, project-management, tyga

## Full References

- [OpenAPI Spec](/docs) — Interactive API docs with swagger UI per module
- [Agent Quickstarts](/docs/quickstart/) — Claude Code, Cursor, Cline, Windsurf, Aider
- [SDK Docs](/docs) — Full module index with endpoint counts