capgo-public-api

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

• Product site: https://capgo.app
• API docs: https://capgo.app/docs/public-api/
• OpenAPI: https://capgo.app/openapi.json
• Well-known OpenAPI: https://capgo.app/.well-known/openapi.json
• Canonical OpenAPI copy: https://capgo.app/.well-known/capgo-public-api-openapi.json
• API base: https://api.capgo.app
• Status page: https://status.capgo.app/

Authentication

Send a Capgo API key in the x-api-key header. The legacy authorization header still accepts a raw key with no Bearer prefix.

curl -H "x-api-key: $CAPGO_API_KEY" https://api.capgo.app/organization/

Create or rotate API keys in the dashboard:

• https://console.capgo.app/settings/organization/api-keys

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.
• Every operation has a unique operationId, a description, typed parameters, and JSON response schemas suitable for LLM function calling.