| name | capgo-public-api |
| description | Use Capgo's public API docs and API-key authentication model to manage organizations, apps, channels, devices, bundles, statistics, and API keys. |
Capgo Public API
Use this skill when the task requires programmatic work with Capgo Cloud instead of manual dashboard navigation.
Base URLs
Authentication
Send a raw Capgo API key in the authorization header. Do not prepend Bearer unless the published API docs change.
curl -H "authorization: $CAPGO_API_KEY" https://api.capgo.app/organization/
Create or rotate API keys in the dashboard:
Main resource groups
/organization/ for organization CRUD and /organization/members/ for member access control
/app/ and /app/:app_id for app listing, creation, updates, and deletion
/apikey/ and /apikey/:id/ for API key lifecycle management
/channel/ for channel rollout configuration
/bundle/ and /bundle/metadata for live-update bundle registration and metadata
/device/ for device overrides and device inventory
/statistics/... for app, organization, user, and bundle-usage analytics
Working rules
- Prefer the published docs and OpenAPI document for request and response details before guessing fields.
- Use least-privilege API keys (
read, upload, write, all).
- Handle
401, 403, and 429 responses explicitly, with retry backoff for 429.
- Standard accounts are limited to 100 requests per minute; enterprise accounts are limited to 1000 requests per minute.
- Expect endpoint-specific JSON success shapes. Many responses use
data or status, but /statistics/... can return top-level arrays and bundle_usage returns an object with labels and datasets, so rely on the OpenAPI before unwrapping. Errors typically include an error field when present.
- Capgo's public API currently uses API-key authentication, not OAuth/OIDC discovery metadata.