# CloudClaw API
> Multi-tenant AI agent hosting platform at mycloudclaw.com

## Base URL
https://mycloudclaw.com

## Authentication
- **Bearer Token**: API key with `cc_` prefix for tenant access
- **MCP Key**: API key with `mcp_` prefix for MCP server access
- **OAuth 2.0**: WorkOS AuthKit for SSO/SAML
- **Wallet Auth**: Crypto wallet signature authentication
- Public endpoints require no authentication

## Rate Limits
- Free tier: 100 requests/min
- Pro tier: 1,000 requests/min
- Enterprise: 10,000 requests/min

## Protocols
- **REST API**: Standard JSON over HTTPS
- **MCP**: Model Context Protocol (Streamable HTTP) at /api/mcp/:tenant_slug
- **A2A**: Agent-to-Agent protocol at /api/a2a
- **OpenAI-Compatible**: Chat completions at /v1/chat/completions


## Endpoints

### 3D Scenes API
GET /api/3d/branding/:tenant_slug
PUT /api/3d/comparisons/:id
DELETE /api/3d/comparisons/:id
GET /api/3d/comparisons/:slug
GET /api/3d/files/*
GET /api/3d/jobs/:id
POST /api/3d/jobs/:id/cancel
POST /api/3d/jobs/:id/retry
GET /api/3d/jobs/stats
GET /api/3d/leads
DELETE /api/3d/leads/:id
GET /api/3d/leads/:id
GET /api/3d/leads/export
POST /api/3d/saas/configure
GET /api/3d/saas/embed/:slug
GET /api/3d/saas/preview/:slug
POST /api/3d/saas/publish/:slug
POST /api/3d/saas/unpublish/:slug
POST /api/3d/saas/upload
GET /api/3d/saas/upload/:id/status
GET /api/3d/saas/usage
POST /api/3d/scenes
GET /api/3d/scenes
PUT /api/3d/scenes/:slug
DELETE /api/3d/scenes/:slug
GET /api/3d/scenes/:slug
GET /api/3d/scenes/:slug/analytics
POST /api/3d/scenes/:slug/leads
PUT /api/3d/scenes/:slug/tour
GET /api/3d/scenes/:slug/tour
POST /api/3d/scenes/:slug/tour/generate-audio
POST /api/3d/scenes/:slug/upload
POST /api/3d/scenes/:slug/upload-url
POST /api/3d/scenes/:slug/view
PUT /api/3d/timelines/:id
DELETE /api/3d/timelines/:id
GET /api/3d/timelines/:id
POST /api/3d/timelines/:id/entries
PUT /api/3d/timelines/:id/entries/:entryId
DELETE /api/3d/timelines/:id/entries/:entryId
GET /api/3d/timelines/:id/export
GET /api/3d/timelines/:slug/public
PUT /api/3d/tours/:id
DELETE /api/3d/tours/:id
GET /api/3d/tours/:id
GET /api/3d/tours/:id/export
POST /api/3d/tours/:id/generate-audio
POST /api/3d/tours/:id/generate-narration
POST /api/3d/tours/:id/waypoints
PUT /api/3d/tours/:id/waypoints/:waypointId
DELETE /api/3d/tours/:id/waypoints/:waypointId
PUT /api/3d/upload
POST /api/3d/v1/scenes
GET /api/3d/v1/scenes
PUT /api/3d/v1/scenes/:slug
DELETE /api/3d/v1/scenes/:slug
GET /api/3d/v1/scenes/:slug
GET /api/3d/v1/scenes/:slug/analytics
GET /api/3d/v1/scenes/:slug/embed
GET /api/3d/v1/scenes/:slug/export
POST /api/3d/v1/scenes/:slug/leads
POST /api/3d/v1/scenes/:slug/upload

### Agent-to-Agent (A2A)
POST /api/a2a/capabilities
GET /api/a2a/capabilities
DELETE /api/a2a/capabilities/:id
POST /api/a2a/messages
GET /api/a2a/messages
POST /api/a2a/messages/:id/process
POST /api/a2a/request

### Academy
GET /api/academy/courses
GET /api/academy/courses/:slug

### Access Control
GET /api/access/audit
POST /api/access/evaluate
PUT /api/access/login-methods
GET /api/access/login-methods
POST /api/access/policies
GET /api/access/policies
PUT /api/access/policies/:id
DELETE /api/access/policies/:id

### Agency
POST /api/agency/clients
GET /api/agency/clients
GET /api/agency/clients/:id
POST /api/agency/clients/:id/reactivate
POST /api/agency/clients/:id/suspend
GET /api/agency/dashboard
GET /api/agency/stats

### Agent Documentation
PUT /api/agent-docs/:id
DELETE /api/agent-docs/:id
GET /api/agent-docs/:id
POST /api/agent-docs/:id/restore/:version
POST /api/agent-docs/:id/versions
GET /api/agent-docs/:id/versions
GET /api/agent-docs/:id/versions/:version
GET /api/agent-docs/by-skill/:skillId
GET /api/agent-docs/search

### Agent Executions
GET /api/agent-executions/:id
POST /api/agent-executions/:id/resume
POST /api/agent-executions/:id/retry
GET /api/agent-executions/stats

### Agent Management
GET /api/agent-management/:agentId/activity
POST /api/agent-management/:agentId/chat
POST /api/agent-management/:agentId/connectors
GET /api/agent-management/:agentId/connectors
DELETE /api/agent-management/:agentId/connectors/:slug
POST /api/agent-management/:agentId/schedules
GET /api/agent-management/:agentId/schedules
DELETE /api/agent-management/:agentId/schedules/:scheduleId
GET /api/agent-management/:agentId/spend
GET /api/agent-management/dashboard

### Agent MCP Server
POST /api/agent-mcp/:agentId
GET /api/agent-mcp/:agentId

### Agent Modes
PUT /api/agent-modes/:agent_slug
GET /api/agent-modes/:agent_slug
POST /api/agent-modes/:agent_slug/kill
POST /api/agent-modes/bulk

### Agent Templates
GET /api/agent-templates/:slug

### Agent Chat
POST /api/agentchat/channels
GET /api/agentchat/channels
POST /api/agentchat/channels/:id/members
GET /api/agentchat/channels/:id/members
POST /api/agentchat/channels/:id/messages
GET /api/agentchat/channels/:id/messages
GET /api/agentchat/channels/:id/ws

### Agent Chat Flows
GET /api/agentchat-flows/events
GET /api/agentchat-flows/graph
GET /api/agentchat-flows/patterns
POST /api/agentchat-flows/predict

### Agent Chat Management
POST /api/agentchat-management/directives
GET /api/agentchat-management/directives
PATCH /api/agentchat-management/directives/:id
DELETE /api/agentchat-management/directives/:id
POST /api/agentchat-management/memory
GET /api/agentchat-management/memory
PATCH /api/agentchat-management/memory/:id
DELETE /api/agentchat-management/memory/:id
POST /api/agentchat-management/memory/search
POST /api/agentchat-management/schedules
GET /api/agentchat-management/schedules
PATCH /api/agentchat-management/schedules/:id
DELETE /api/agentchat-management/schedules/:id
POST /api/agentchat-management/tasks
GET /api/agentchat-management/tasks
PATCH /api/agentchat-management/tasks/:id
GET /api/agentchat-management/tasks/:id
POST /api/agentchat-management/tasks/:id/subtasks

### Agents
PUT /api/agents/:slug
DELETE /api/agents/:slug
GET /api/agents/:slug
PUT /api/agents/:slug/access
PUT /api/agents/:slug/access-profile
GET /api/agents/:slug/access-profile
PUT /api/agents/:slug/budget
GET /api/agents/:slug/budget
POST /api/agents/:slug/chat — Chat with an agent
POST /api/agents/:slug/chat/stream — Stream chat with an agent
GET /api/agents/:slug/compliance
POST /api/agents/:slug/confidence
GET /api/agents/:slug/confidence
GET /api/agents/:slug/confidence/summary
GET /api/agents/:slug/costs
POST /api/agents/:slug/knowledge
GET /api/agents/:slug/knowledge
DELETE /api/agents/:slug/knowledge/:sourceId
POST /api/agents/:slug/knowledge/search
GET /api/agents/:slug/knowledge/stats
GET /api/agents/:slug/llms.txt — Per-agent llms.txt
PUT /api/agents/:slug/manifest
GET /api/agents/:slug/manifest
GET /api/agents/:slug/memory
PUT /api/agents/:slug/memory/:key
DELETE /api/agents/:slug/memory/:key
GET /api/agents/:slug/memory/:key
POST /api/agents/:slug/memory/bulk
POST /api/agents/:slug/memory/documents
GET /api/agents/:slug/memory/documents
DELETE /api/agents/:slug/memory/documents/:id
POST /api/agents/:slug/memory/search
PUT /api/agents/:slug/model
DELETE /api/agents/:slug/purge
GET /api/agents/:slug/scores
GET /api/agents/:slug/scores/summary
DELETE /api/agents/:slug/state
GET /api/agents/:slug/state
PUT /api/agents/:slug/state/:key
DELETE /api/agents/:slug/state/:key
GET /api/agents/:slug/state/:key
GET /api/agents/:slug/versions
GET /api/agents/:slug/versions/:version
POST /api/agents/:slug/voice/synthesize
POST /api/agents/:slug/voice/transcribe
GET /api/agents/budget-summary
GET /api/agents/counts-by-tenant
POST /api/agents/deploy — Deploy tenant agents
GET /api/agents/discover — Public agent discovery
GET /api/agents/models
POST /api/agents/reset-budgets
GET /api/agents/tagline-suggestions
GET /api/agents/verification/results
GET /api/agents/verification/stats
POST /api/agents/verification/verify

### AI Gateway & Models
DELETE /api/ai/cache
GET /api/ai/cache/stats
POST /api/ai/chains
GET /api/ai/chains
PUT /api/ai/chains/:id
DELETE /api/ai/chains/:id
POST /api/ai/chat — AI chat completion
GET /api/ai/logs
GET /api/ai/models
GET /api/ai/models/:id
GET /api/ai/token-packs
GET /api/ai/tokens/balance
POST /api/ai/tokens/purchase
POST /api/ai/tokens/spend
GET /api/ai/tokens/usage

### Analytics
GET /api/analytics/agents/:slug/activity
GET /api/analytics/agents/:slug/stats
GET /api/analytics/agents/costs
GET /api/analytics/agents/errors
GET /api/analytics/agents/overview
GET /api/analytics/agents/realtime
GET /api/analytics/daily-stats
GET /api/analytics/events/summary
GET /api/analytics/export
GET /api/analytics/interactions
GET /api/analytics/overview
GET /api/analytics/summary
GET /api/analytics/usage

### Approvals (HITL)
GET /api/approvals/:id
POST /api/approvals/:id/approve — Approve a pending decision
POST /api/approvals/:id/reject — Reject a pending decision
PUT /api/approvals/config
GET /api/approvals/config

### ARC Credits & Wallet
POST /api/arc/apply-promo
GET /api/arc/balance/:wallet_id
POST /api/arc/cashout
GET /api/arc/cashouts/:wallet_id
GET /api/arc/checkout/:id
POST /api/arc/checkout/confirm
POST /api/arc/checkout/create
POST /api/arc/earn
POST /api/arc/payments/invoice
DELETE /api/arc/payments/invoice/:id
GET /api/arc/payments/invoice/:id
GET /api/arc/payments/invoices
POST /api/arc/payments/link
DELETE /api/arc/payments/link/:id
GET /api/arc/payments/link/:id
POST /api/arc/payments/pay/:id
GET /api/arc/payments/revenue
POST /api/arc/payments/subscription
DELETE /api/arc/payments/subscription/:id
POST /api/arc/payments/subscription/:id/bill
GET /api/arc/payments/subscriptions
POST /api/arc/payments/subscriptions/process-due
GET /api/arc/pricing
PATCH /api/arc/promos/:id
DELETE /api/arc/promos/:id
GET /api/arc/promos/:id/stats
POST /api/arc/promos/apply
GET /api/arc/promos/available
POST /api/arc/purchase
POST /api/arc/spend
GET /api/arc/tenant-balance/:tenant_id
GET /api/arc/transactions/:wallet_id
POST /api/arc/transfer
GET /api/arc/wallet
GET /api/arc/wallets

### Authentication
DELETE /api/auth/account
GET /api/auth/export-data
POST /api/auth/forgot-password
POST /api/auth/login
POST /api/auth/logout
GET /api/auth/me — Get current user
POST /api/auth/refresh
POST /api/auth/register
POST /api/auth/reset-password
POST /api/auth/send-verification
POST /api/auth/signup
GET /api/auth/sso/callback
GET /api/auth/sso/login
POST /api/auth/sso/logout
GET /api/auth/verify-email
POST /api/auth/wallet/login
GET /api/auth/wallet/me
GET /api/auth/wallet/nonce
GET /api/auth/wallet/solana-nonce
POST /api/auth/wallet/solana-verify
POST /api/auth/wallet/verify

### Auto-Research
GET /api/autoresearch/experiments
GET /api/autoresearch/experiments/:id
POST /api/autoresearch/experiments/:id/accept
POST /api/autoresearch/experiments/:id/reject
POST /api/autoresearch/improve
POST /api/autoresearch/run
GET /api/autoresearch/runs
POST /api/autoresearch/score
GET /api/autoresearch/stats

### Business Development Kit
GET /api/bdk/businesses
GET /api/bdk/businesses/:id
GET /api/bdk/businesses/:id/dashboard
POST /api/bdk/businesses/:id/pause
POST /api/bdk/businesses/:id/resume
GET /api/bdk/businesses/:id/team
POST /api/bdk/deploy
POST /api/bdk/deploy-team

### Billing & Subscriptions
POST /api/billing/cancel
POST /api/billing/change-plan
POST /api/billing/checkout
POST /api/billing/create-checkout-session
POST /api/billing/create-portal-session
GET /api/billing/credits
POST /api/billing/credits/purchase
GET /api/billing/credits/usage
GET /api/billing/plan-limits
GET /api/billing/plan-limits/:slug
GET /api/billing/plans — List available plans
GET /api/billing/plans/:slug
POST /api/billing/portal
POST /api/billing/subscribe
GET /api/billing/subscription
GET /api/billing/trial
POST /api/billing/trial/extend
POST /api/billing/upgrade
POST /api/billing/usage
GET /api/billing/usage
GET /api/billing/usage-events
POST /api/billing/webhook
POST /api/billing/webhooks

### Budgets
PUT /api/budgets/:agent_slug
GET /api/budgets/:agent_slug
POST /api/budgets/:agent_slug/check
POST /api/budgets/:agent_slug/reset
GET /api/budgets/alerts
POST /api/budgets/alerts/:id/acknowledge
POST /api/budgets/init
GET /api/budgets/presets
GET /api/budgets/summary

### Business Templates
GET /api/business-templates/:slug
POST /api/business-templates/:slug/deploy
GET /api/business-templates/deployed

### BYOK Key Vault
DELETE /api/byok/:id
POST /api/byok/:id/validate

### Channels
PUT /api/channels/:id
DELETE /api/channels/:id
GET /api/channels/:id
GET /api/channels/:id/messages
POST /api/channels/:id/send
POST /api/channels/send
GET /api/channels/stats
POST /api/channels/telegram/setup
POST /api/channels/webhook/discord
POST /api/channels/webhook/email
POST /api/channels/webhook/facebook_messenger
GET /api/channels/webhook/facebook_messenger
POST /api/channels/webhook/instagram
GET /api/channels/webhook/instagram
POST /api/channels/webhook/matrix
POST /api/channels/webhook/signal
POST /api/channels/webhook/slack
POST /api/channels/webhook/sms
POST /api/channels/webhook/telegram
POST /api/channels/webhook/webchat
POST /api/channels/webhook/whatsapp
GET /api/channels/webhook/whatsapp

### Chatrooms
DELETE /api/chatrooms/:id
GET /api/chatrooms/:id
POST /api/chatrooms/:id/members
DELETE /api/chatrooms/:id/members/:memberId
POST /api/chatrooms/:id/messages
GET /api/chatrooms/:id/messages
GET /api/chatrooms/:id/ws
POST /api/chatrooms/for-task

### Commands
PUT /api/commands/:slug
DELETE /api/commands/:slug
GET /api/commands/:slug
POST /api/commands/:slug/execute
GET /api/commands/:slug/executions
GET /api/commands/:slug/executions/:executionId
POST /api/commands/:slug/executions/:executionId/cancel
GET /api/commands/:slug/export
POST /api/commands/:slug/install
DELETE /api/commands/:slug/install
POST /api/commands/:slug/rate
POST /api/commands/:slug/versions
GET /api/commands/:slug/versions
GET /api/commands/:slug/versions/:version
GET /api/commands/installed
POST /api/commands/match

### Connectors
GET /api/connectors/:slug
POST /api/connectors/:slug/install
DELETE /api/connectors/:slug/install
GET /api/connectors/:slug/ratings
GET /api/connectors/:slug/versions
PUT /api/connectors/a2a/:id
DELETE /api/connectors/a2a/:id
GET /api/connectors/a2a/:id
POST /api/connectors/a2a/:id/discover
POST /api/connectors/a2a/:id/task
GET /api/connectors/a2a/:id/tasks
GET /api/connectors/categories
GET /api/connectors/featured
GET /api/connectors/installed
PUT /api/connectors/installed/:id
POST /api/connectors/installed/:id/pause
POST /api/connectors/installed/:id/resume
PUT /api/connectors/mcp/:id
DELETE /api/connectors/mcp/:id
GET /api/connectors/mcp/:id
POST /api/connectors/mcp/:id/invoke
POST /api/connectors/mcp/:id/sync
DELETE /api/connectors/mcp/cache
GET /api/connectors/mcp/cache/stats
POST /api/connectors/mcp/installed
GET /api/connectors/mcp/installed
DELETE /api/connectors/mcp/installed/:id
GET /api/connectors/mcp/rate-limits
POST /api/connectors/mcp/registry
GET /api/connectors/mcp/registry
GET /api/connectors/mcp/registry/:slug
POST /api/connectors/mcp/skill-connectors
GET /api/connectors/mcp/skill-connectors/:skill_id
POST /api/connectors/mcp/whitelist
GET /api/connectors/mcp/whitelist
DELETE /api/connectors/mcp/whitelist/:id
GET /api/connectors/openclaw/:id
GET /api/connectors/openclaw/agents/:slug/skills
DELETE /api/connectors/openclaw/agents/:slug/skills/:skillId
POST /api/connectors/openclaw/agents/:slug/skills/:skillId/install
POST /api/connectors/openclaw/import
GET /api/connectors/openclaw/imports
GET /api/connectors/openclaw/search
GET /api/connectors/purchases/:id
POST /api/connectors/purchases/:id/approve
POST /api/connectors/purchases/:id/reject
POST /api/connectors/security/flag
GET /api/connectors/security/flags
POST /api/connectors/security/scan
GET /api/connectors/security/scan/:id
POST /api/connectors/submit

### Content & Generation
POST /api/content/blueprints
GET /api/content/blueprints
PATCH /api/content/blueprints/:id
DELETE /api/content/blueprints/:id
POST /api/content/eval
PUT /api/content/guidelines
GET /api/content/guidelines
POST /api/content/items
GET /api/content/items
PATCH /api/content/items/:id
GET /api/content/items/:id
POST /api/content/items/:id/approve
POST /api/content/items/:id/publish
POST /api/content/items/:id/reject
POST /api/content/items/:id/request-changes
GET /api/content/prompt-versions
GET /api/content/research-log
GET /api/content/research-log/:id
POST /api/content/topics
GET /api/content/topics
PATCH /api/content/topics/:id
DELETE /api/content/topics/:id

### Context Rules
PUT /api/context-rules/:id
DELETE /api/context-rules/:id

### Credentials
GET /api/credentials/:agent_slug/active
GET /api/credentials/:agent_slug/audit
POST /api/credentials/:agent_slug/revoke
POST /api/credentials/:agent_slug/rotate
GET /api/credentials/anomalies
POST /api/credentials/cleanup
POST /api/credentials/issue
GET /api/credentials/stats
POST /api/credentials/validate

### Credits
GET /api/credits/balance
GET /api/credits/history
GET /api/credits/packages
GET /api/credits/packages/:slug
GET /api/credits/pending
POST /api/credits/purchase
POST /api/credits/purchase/direct
POST /api/credits/spend

### Custom Hostnames
DELETE /api/custom-hostnames/:id
GET /api/custom-hostnames/:id
POST /api/custom-hostnames/:id/refresh
POST /api/custom-hostnames/:id/verify

### Delivery Tracking
POST /api/delivery/auto-create
POST /api/delivery/checklists
GET /api/delivery/checklists
PATCH /api/delivery/checklists/:id
GET /api/delivery/checklists/:id
POST /api/delivery/checklists/:id/compare
GET /api/delivery/checklists/:id/compare
POST /api/delivery/checklists/:id/items
PATCH /api/delivery/items/:itemId
DELETE /api/delivery/items/:itemId
GET /api/delivery/metrics
GET /api/delivery/metrics/:agentId
POST /api/delivery/metrics/snapshot
GET /api/delivery/report/:checklistId
POST /api/delivery/templates
GET /api/delivery/templates
GET /api/delivery/templates/:taskType
POST /api/delivery/validate/:checklistId

### Agent Deployer
GET /api/deploy/:id
POST /api/deploy/:id/pause
POST /api/deploy/:id/resume
POST /api/deploy/:id/terminate
POST /api/deploy/batch
POST /api/deploy/health-check
GET /api/deploy/stats

### Email
GET /api/email/analytics
GET /api/email/analytics/:emailId
GET /api/email/domain-status
GET /api/email/drip-status
GET /api/email/log
POST /api/email/process-drip
POST /api/email/resend
POST /api/email/send-test
POST /api/email/test-drip
POST /api/email/unsubscribe
GET /api/email/unsubscribe

### Events
GET /api/events/:id
POST /api/events/subscribe
DELETE /api/events/subscribe/:id
GET /api/events/subscriptions

### Hooks
PUT /api/hooks/:id
DELETE /api/hooks/:id
GET /api/hooks/:id
POST /api/hooks/:id/test
GET /api/hooks/log
GET /api/hooks/presets
POST /api/hooks/presets/:slug

### Instruction Registry
POST /api/instructions/assemble/:agentId
PUT /api/instructions/assemblies/:agentId
GET /api/instructions/assemblies/:agentId
POST /api/instructions/bindings/:agentId
GET /api/instructions/bindings/:agentId
POST /api/instructions/contracts
GET /api/instructions/contracts
PUT /api/instructions/contracts/:name
GET /api/instructions/contracts/:name
POST /api/instructions/contracts/validate
POST /api/instructions/templates
GET /api/instructions/templates
PUT /api/instructions/templates/:slug
DELETE /api/instructions/templates/:slug
GET /api/instructions/templates/:slug

### Invoices
PUT /api/invoices/:id
GET /api/invoices/:id

### Knowledge Base
PUT /api/knowledge/:id
GET /api/knowledge/:id
GET /api/knowledge/:id/related
POST /api/knowledge/ask
GET /api/knowledge/graph
POST /api/knowledge/import
POST /api/knowledge/import-docs
POST /api/knowledge/link
POST /api/knowledge/reindex
GET /api/knowledge/search
POST /api/knowledge/seed
GET /api/knowledge/stats

### Leads
PUT /api/leads/:id
GET /api/leads/:id
GET /api/leads/count
GET /api/leads/position/:email
GET /api/leads/stats

### Legal
POST /api/legal/accept
GET /api/legal/documents
GET /api/legal/documents/:type
POST /api/legal/seed
GET /api/legal/status/:tenantId

### Marketplace
PUT /api/marketplace/:slug
GET /api/marketplace/:slug
GET /api/marketplace/:slug/benchmarks
POST /api/marketplace/:slug/description-tune
POST /api/marketplace/:slug/docs
GET /api/marketplace/:slug/docs
DELETE /api/marketplace/:slug/docs/:version
GET /api/marketplace/:slug/docs/:version
GET /api/marketplace/:slug/docs/:version/:doc_type
GET /api/marketplace/:slug/docs/diff
POST /api/marketplace/:slug/docs/publish
POST /api/marketplace/:slug/docs/rollback
GET /api/marketplace/:slug/docs/search
POST /api/marketplace/:slug/evals
GET /api/marketplace/:slug/evals
PUT /api/marketplace/:slug/evals/:id
DELETE /api/marketplace/:slug/evals/:id
GET /api/marketplace/:slug/evals/:id
POST /api/marketplace/:slug/evals/:id/run
GET /api/marketplace/:slug/evals/:id/runs
POST /api/marketplace/:slug/evals/run-all
POST /api/marketplace/:slug/install
DELETE /api/marketplace/:slug/install
POST /api/marketplace/:slug/rate
GET /api/marketplace/:slug/ratings
GET /api/marketplace/:slug/regression-alerts
PUT /api/marketplace/:slug/regression-alerts/:id
GET /api/marketplace/:slug/regression-alerts/:id
POST /api/marketplace/:slug/regression-alerts/:id/acknowledge
POST /api/marketplace/:slug/regression-alerts/:id/ignore
POST /api/marketplace/:slug/regression-alerts/:id/reopen
POST /api/marketplace/:slug/regression-alerts/:id/resolve
POST /api/marketplace/:slug/regression-alerts/check
GET /api/marketplace/:slug/regression-alerts/stats
PUT /api/marketplace/:slug/review
POST /api/marketplace/:slug/trigger-samples
GET /api/marketplace/:slug/trigger-samples
PUT /api/marketplace/:slug/trigger-samples/:id
DELETE /api/marketplace/:slug/trigger-samples/:id
POST /api/marketplace/:slug/trigger-test
PATCH /api/marketplace/apis/:slug
GET /api/marketplace/apis/:slug
POST /api/marketplace/apis/:slug/call
GET /api/marketplace/apis/:slug/openapi
POST /api/marketplace/apis/:slug/rate
GET /api/marketplace/apis/my-apis
GET /api/marketplace/categories
GET /api/marketplace/featured
GET /api/marketplace/my-skills
GET /api/marketplace/review-queue
POST /api/marketplace/seed
POST /api/marketplace/submit
GET /api/marketplace/templates/:slug
POST /api/marketplace/templates/:slug/deploy
POST /api/marketplace/templates/:slug/rate
GET /api/marketplace/templates/featured
GET /api/marketplace/v2/:slug
POST /api/marketplace/v2/:slug/install
POST /api/marketplace/v2/:slug/reviews
GET /api/marketplace/v2/:slug/reviews
DELETE /api/marketplace/v2/:slug/uninstall
GET /api/marketplace/v2/categories
GET /api/marketplace/v2/featured
GET /api/marketplace/v2/status

### MCP Server
POST /api/mcp/:tenantSlug — Streamable HTTP MCP endpoint
GET /api/mcp/:tenantSlug — MCP server info
GET /api/mcp/:tenantSlug/sse — MCP SSE transport
POST /api/mcp/discover — Discover available MCP tools
GET /api/mcp/discover

### MCP Keys
DELETE /api/mcp-keys/:id

### Monetization
GET /api/monetization/agents/:slug/access-check
POST /api/monetization/agents/:slug/checkout
PUT /api/monetization/agents/:slug/pricing
GET /api/monetization/agents/:slug/pricing
POST /api/monetization/coinbase/configure
PUT /api/monetization/config
GET /api/monetization/config
POST /api/monetization/connect/disconnect
POST /api/monetization/connect/onboard
GET /api/monetization/connect/status
GET /api/monetization/earnings
GET /api/monetization/payouts
POST /api/monetization/webhooks/coinbase
POST /api/monetization/webhooks/stripe-connect

### Objectives
PUT /api/objectives/:id
GET /api/objectives/:id
GET /api/objectives/:id/actions
GET /api/objectives/:id/outcomes
POST /api/objectives/:id/pipeline
GET /api/objectives/:id/pipeline
PUT /api/objectives/:id/pipeline/:stageId
GET /api/objectives/:id/tasks

### Onboarding
POST /api/onboarding/complete
POST /api/onboarding/create-agent
POST /api/onboarding/go-live
POST /api/onboarding/mark-complete
POST /api/onboarding/start
GET /api/onboarding/status

### OpenAPI
GET /api/openapi/:slug
GET /api/openapi/all
GET /api/openapi/chatgpt
GET /api/openapi/platform

### Operators
PUT /api/operators/:id
DELETE /api/operators/:id
GET /api/operators/:id
POST /api/operators/review
GET /api/operators/reviews

### Partner Portal
DELETE /api/partner/api-keys/:id
POST /api/partner/clients
GET /api/partner/clients
GET /api/partner/clients/:tenantId
GET /api/partner/commissions
GET /api/partner/commissions/summary
GET /api/partner/dashboard
GET /api/partner/onboarding/checklist/:tenantId
POST /api/partner/onboarding/setup-agent
POST /api/partner/onboarding/setup-channel
POST /api/partner/onboarding/start
GET /api/partner/payouts
POST /api/partner/payouts/request
PUT /api/partner/profile
GET /api/partner/profile
PUT /api/partner/referral-codes/:id
DELETE /api/partner/referral-codes/:id
GET /api/partner/referral-codes/:id/stats
PUT /api/partner/shortlinks/:id
DELETE /api/partner/shortlinks/:id
GET /api/partner/shortlinks/:id/analytics
GET /api/partner/shortlinks/go/:slug
GET /api/partner/tier

### Payments (Stripe)
GET /api/payments/:id
POST /api/payments/create-intent
GET /api/payments/stats
POST /api/payments/webhook

### Plugins
PUT /api/plugins/:slug
DELETE /api/plugins/:slug
GET /api/plugins/:slug
GET /api/plugins/:slug/export
POST /api/plugins/:slug/install
DELETE /api/plugins/:slug/install
POST /api/plugins/:slug/publish
POST /api/plugins/:slug/purchase
POST /api/plugins/:slug/rate
GET /api/plugins/:slug/revenue
POST /api/plugins/:slug/revenue/settle
GET /api/plugins/:slug/revenue/transactions
POST /api/plugins/:slug/versions
GET /api/plugins/:slug/versions
GET /api/plugins/:slug/versions/:version
GET /api/plugins/authored
GET /api/plugins/claude-code/all
POST /api/plugins/claude-code/generate
GET /api/plugins/claude-code/install-guide
GET /api/plugins/installed
GET /api/plugins/revenue/summary

### Promos
GET /api/promos/credits
POST /api/promos/redeem
GET /api/promos/validate/:code

### Recordings
DELETE /api/recordings/:id
GET /api/recordings/:id
POST /api/recordings/:id/export
GET /api/recordings/:id/frames/:filename
POST /api/recordings/create
GET /api/recordings/pricing
POST /api/recordings/quick

### Referral Codes
GET /api/referral/code/:tenant_id
POST /api/referral/convert
GET /api/referral/stats/:tenant_id
POST /api/referral/track

### Referrals
GET /api/referrals/code
POST /api/referrals/convert
GET /api/referrals/leaderboard
POST /api/referrals/track

### Repair Orders
GET /api/repair-orders/:ro_id
POST /api/repair-orders/:ro_id/status
GET /api/repair-orders/customer/:phone
POST /api/repair-orders/customer/subscription
POST /api/repair-orders/customer/unsubscribe

### Research
POST /api/research/basic
POST /api/research/deep
POST /api/research/enterprise
GET /api/research/history
GET /api/research/search

### Resellers
PUT /api/resellers/:id
GET /api/resellers/:id
GET /api/resellers/:id/tenants

### Schedules
PUT /api/schedules/:id
DELETE /api/schedules/:id
GET /api/schedules/:id
POST /api/schedules/:id/trigger
GET /api/schedules/due

### Secrets Vault
PUT /api/secrets/:id
DELETE /api/secrets/:id
GET /api/secrets/:id
GET /api/secrets/:id/audit
POST /api/secrets/:id/rotate
GET /api/secrets/rotation-due

### SEO
GET /api/seo/audit
GET /api/seo/competitors
POST /api/seo/content-score
POST /api/seo/geo-check

### Services
GET /api/services/screenshot/:id
GET /api/services/screenshot/stats

### ShieldScan (Security Scanning)
POST /api/scan — Free PII scan (public, rate-limited, 3/IP/day)
POST /api/scan/full — AI-enhanced full scan (auth required)
GET /api/scan/history — Scan history (auth required)
POST /api/shieldscan/scan/full/:tenantId — Unified scan via Cloudflare Workflow (auth required)
GET /api/shieldscan/scan/status/:scanId — Get unified scan status
GET /api/shieldscan/scan/history/:tenantId — List past unified scans
GET /api/shieldscan/cves — Browse CVE database (NVD, CISA KEV, EPSS scores)
GET /api/shieldscan/kev — CISA Known Exploited Vulnerabilities catalog
GET /api/shieldscan/alerts/:tenantId — Vulnerability alerts for tenant assets
POST /api/shieldscan/assets — Register assets for monitoring
POST /api/shieldscan/ingest/nvd — Trigger NVD ingestion (admin)
POST /api/shieldscan/ingest/kev — Trigger KEV ingestion (admin)
POST /api/shieldscan/ingest/epss — Trigger EPSS ingestion (admin)
POST /api/shieldscan/scan/:tenantId — Run CVE scan against tenant assets

### Sessions
POST /api/sessions/track

### Signup
POST /api/signup/agent — Create agent account programmatically
POST /api/signup/complete
POST /api/signup/free
GET /api/signup/verify/:token

### Sites
PUT /api/sites/:id
GET /api/sites/:id

### Skills
PUT /api/skills/:slug
GET /api/skills/:slug/export
POST /api/skills/:slug/triggers
GET /api/skills/:slug/triggers
DELETE /api/skills/:slug/triggers/:triggerId
POST /api/skills/:slug/versions
GET /api/skills/:slug/versions
GET /api/skills/:slug/versions/:version
POST /api/skills/match

### Social Network
GET /api/social/achievements
POST /api/social/communities
GET /api/social/communities
GET /api/social/communities/:idOrSlug
POST /api/social/connect/:tenantId
POST /api/social/connect/:tenantId/accept
GET /api/social/connections
POST /api/social/events
GET /api/social/events
GET /api/social/events/:id
POST /api/social/events/:id/register
GET /api/social/feed
GET /api/social/leaderboard
POST /api/social/posts
GET /api/social/posts
GET /api/social/posts/:id
POST /api/social/posts/:id/comment
POST /api/social/posts/:id/like
POST /api/social/profile
PUT /api/social/profile
GET /api/social/profile
GET /api/social/profile/:tenantId
GET /api/social/profiles
GET /api/social/stats

### SOPs
GET /api/sops/:id
POST /api/sops/:id/executions
GET /api/sops/:id/executions
POST /api/sops/:id/test
POST /api/sops/:id/test-cases
GET /api/sops/compliance

### Sub-Agents
GET /api/sub-agents/:id
POST /api/sub-agents/:id/cancel
POST /api/sub-agents/:id/execute
GET /api/sub-agents/:id/results
POST /api/sub-agents/:id/summary
POST /api/sub-agents/batch
GET /api/sub-agents/batch/:batchId
GET /api/sub-agents/rate-limit
POST /api/sub-agents/spawn

### Support
POST /api/support/tickets
GET /api/support/tickets
GET /api/support/tickets/:id
POST /api/support/tickets/:id/comments

### Swarm
POST /api/swarm/dispatch
GET /api/swarm/history
GET /api/swarm/status/:task_id
POST /api/swarm/teams
GET /api/swarm/teams
GET /api/swarm/teams/:name
GET /api/swarm/ws

### Team
GET /api/team/audit
POST /api/team/invite
DELETE /api/team/invite/:id
POST /api/team/invite/:token/accept
GET /api/team/members
DELETE /api/team/members/:id
PUT /api/team/members/:id/role
PUT /api/team/security-policy
GET /api/team/security-policy
GET /api/team/sessions
DELETE /api/team/sessions/:id

### Teams
PUT /api/teams/:id
DELETE /api/teams/:id
GET /api/teams/:id
POST /api/teams/:id/dispatch
POST /api/teams/:id/members
DELETE /api/teams/:id/members/:slug
POST /api/teams/:id/plan
GET /api/teams/:id/results
POST /api/teams/:id/tasks
GET /api/teams/:id/tasks
PUT /api/teams/:id/tasks/:taskId

### Tenants
PUT /api/tenants/:id
DELETE /api/tenants/:id
GET /api/tenants/:id — Get tenant info
PUT /api/tenants/:id/reactivate
PUT /api/tenants/:id/suspend

### Tools
GET /api/tools/:name
POST /api/tools/:name/execute
PUT /api/tools/:name/toggle
POST /api/tools/content-gen
POST /api/tools/landing-page
POST /api/tools/landing-page/preview
POST /api/tools/market-research
POST /api/tools/roi-calculator
POST /api/tools/seo-keywords

### Usage
GET /api/usage/agents
GET /api/usage/cost-breakdown
GET /api/usage/current
GET /api/usage/daily-series
GET /api/usage/history
GET /api/usage/limits
GET /api/usage/summary
GET /api/usage/today

### Voice Forms
PUT /api/voice-forms/:id
DELETE /api/voice-forms/:id
GET /api/voice-forms/:id
GET /api/voice-forms/:id/submissions
PATCH /api/voice-forms/:id/submissions/:subId
GET /api/voice-forms/:id/submissions/:subId
POST /api/voice-forms/:id/submit
POST /api/voice-forms/agent/sessions
GET /api/voice-forms/agent/sessions/:agentId/status
POST /api/voice-forms/agent/sessions/:agentId/transcript
POST /api/voice-forms/extraction/extract
POST /api/voice-forms/extraction/extract/batch
POST /api/voice-forms/extraction/schemas
GET /api/voice-forms/extraction/schemas
GET /api/voice-forms/extraction/submissions/:id/extracted
POST /api/voice-forms/extraction/summarize
GET /api/voice-forms/templates
GET /api/voice-forms/templates/:id
GET /api/voice-forms/widget.js

### Waitlist
PUT /api/waitlist/:id
GET /api/waitlist/:id
GET /api/waitlist/count
GET /api/waitlist/position/:email
GET /api/waitlist/stats

### Web Agent
POST /api/web-agent/accessibility
POST /api/web-agent/console
POST /api/web-agent/execute
POST /api/web-agent/extract
POST /api/web-agent/inspect
POST /api/web-agent/links
POST /api/web-agent/performance
POST /api/web-agent/query
POST /api/web-agent/screenshot
GET /api/web-agent/screenshots/:filename

### Webhooks
POST /api/webhooks
GET /api/webhooks
PUT /api/webhooks/:id
DELETE /api/webhooks/:id
GET /api/webhooks/:id
GET /api/webhooks/:id/deliveries
POST /api/webhooks/:id/test
POST /api/webhooks/resend

### White Label
GET /api/whitelabel/preview

### Workflows
GET /api/workflows/:id
POST /api/workflows/:id/cancel
POST /api/workflows/:id/signal
GET /api/workflows/active
GET /api/workflows/stats

### SaaS Template Generator
POST /api/saas-template/generate — Generate standard SaaS pages (landing, pricing, docs, changelog, login)
GET /api/saas-template/preview/:page?domain= — Preview a generated page
GET /api/saas-template/pages — List available page types and config schema

### Workspaces
PUT /api/workspaces/:slug
DELETE /api/workspaces/:slug
GET /api/workspaces/:slug
POST /api/workspaces/:wsSlug/desks
GET /api/workspaces/:wsSlug/desks
PUT /api/workspaces/:wsSlug/desks/:deskSlug
DELETE /api/workspaces/:wsSlug/desks/:deskSlug
GET /api/workspaces/:wsSlug/desks/:deskSlug
POST /api/workspaces/:wsSlug/desks/:deskSlug/contacts
GET /api/workspaces/:wsSlug/desks/:deskSlug/contacts
PUT /api/workspaces/:wsSlug/desks/:deskSlug/contacts/:id
DELETE /api/workspaces/:wsSlug/desks/:deskSlug/contacts/:id
POST /api/workspaces/:wsSlug/desks/:deskSlug/notes
GET /api/workspaces/:wsSlug/desks/:deskSlug/notes
PUT /api/workspaces/:wsSlug/desks/:deskSlug/notes/:id
DELETE /api/workspaces/:wsSlug/desks/:deskSlug/notes/:id
POST /api/workspaces/:wsSlug/desks/:deskSlug/resources
GET /api/workspaces/:wsSlug/desks/:deskSlug/resources
PUT /api/workspaces/:wsSlug/desks/:deskSlug/resources/:id
DELETE /api/workspaces/:wsSlug/desks/:deskSlug/resources/:id
POST /api/workspaces/:wsSlug/desks/:deskSlug/tasks
GET /api/workspaces/:wsSlug/desks/:deskSlug/tasks
PUT /api/workspaces/:wsSlug/desks/:deskSlug/tasks/:id
DELETE /api/workspaces/:wsSlug/desks/:deskSlug/tasks/:id
GET /api/workspaces/all-contacts
GET /api/workspaces/all-resources
GET /api/workspaces/all-tasks

### x402 Payments
GET /api/x402/earnings
GET /api/x402/pricing

### Well-Known Discovery
GET /.well-known/agent.json — A2A agent card
GET /.well-known/agents — Discover public agents
GET /.well-known/ai-plugin.json — ChatGPT plugin manifest
GET /.well-known/humans.txt
GET /.well-known/llms.txt — LLM-friendly API reference
GET /.well-known/mcp-registry-auth
GET /.well-known/mcp.json — MCP server discovery
GET /.well-known/mcp/server-card.json
GET /.well-known/openai-apps-challenge
GET /.well-known/registry.json

### OpenAI-Compatible (v1)
POST /v1/chat/completions — OpenAI-compatible chat
GET /v1/models — List available models

### OAuth
POST /oauth/authorize
GET /oauth/authorize
POST /oauth/register
POST /oauth/token

### Embed Widgets
GET /embed/chat.js — Embeddable chat widget
GET /embed/voice-form.js — Embeddable voice form

## Discovery
GET /llms.txt — This document
GET /llms-full.txt — Extended version with schemas
GET /openapi.json — OpenAPI 3.0 specification
GET /.well-known/mcp.json — MCP server discovery
GET /.well-known/agent.json — A2A agent card
GET /.well-known/ai-plugin.json — ChatGPT plugin manifest
GET /robots.txt — AI crawler directives
GET /sitemap.xml — XML sitemap

## MCP Server
CloudClaw exposes a Model Context Protocol server per tenant:
- Endpoint: POST /api/mcp/:tenant_slug
- Auth: Bearer mcp_xxxx (MCP API key)
- Protocol: Streamable HTTP (2025-11-25 spec)
- 20+ tools for agent management, connectors, knowledge, and more

## Connectors
CloudClaw includes 80+ service connectors including:
GitHub, Slack, HubSpot, Stripe, Twilio SMS, 1Password, Todoist,
Linear, Notion, Gmail, Google Calendar, Jira, Salesforce, and more.

## Products
- **ShieldScan**: Security scanning platform — PII detection, CVE intelligence, unified vulnerability scans. Landing: /shieldscan (SMB), /shieldscan/msp (MSP), /shieldscan/enterprise
- **Screenshot API**: Browser rendering service at /services/screenshot — $0.10/screenshot via ARC billing
- **Free Tools**: /api/tools/market-research, /api/tools/landing-page, /api/tools/roi-calculator, /api/tools/content-gen, /api/tools/seo-keywords

## Support
- Documentation: https://mycloudclaw.com/docs/mcp
- Status: https://mycloudclaw.com/api/status