find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/capgo-app:capgo-app-channels-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Capgo Public Channels API
  summary: REST API for managing Capgo organizations, apps, live update channels, bundles, devices, analytics, and API keys.
  description: 'Use this API to automate Capgo Cloud instead of clicking through the dashboard.


    ## Authentication


    Send a Capgo API key in the `x-api-key` header, or as `Authorization: Bearer `. The legacy `authorization` header with the raw key (no Bearer prefix) is still accepted. Generate keys at https://console.capgo.app/settings/organization/api-keys. Each key carries role bindings (organization, app or channel roles such as `org_admin`, `app_developer` or `app_reader`), so a key only reaches the organizations, apps and channels it was granted.


    Agents can also get a key through OAuth 2.0: authorization code with PKCE (S256) and dynamic client registration, issuer `https://capgo.app` (metadata at https://capgo.app/.well-known/oauth-authorization-server). The user picks which organizations to grant on the consent screen, and the access token is a Capgo API key sent as a Bearer token. The only OAuth scope is `capgo`; access is narrowed by the organizations the user selects, not by scope.


    ## Versioning and deprecation


    The API is versioned by date. Pin a version with the `capgo_api` request header, for example `capgo_api: 2025-10-01`; without the header you get the default version, currently `2025-10-01`. Changes within a version are additive: new endpoints, new optional parameters and new response fields. A breaking change ships as a new dated version, and clients pinned to an older date keep the old behavior. An unknown or malformed version is rejected with `400 unsupported_capgo_api_version` or `400 invalid_capgo_api_version`. Removing an operation or field is a breaking change, so it only happens in a new dated version. Nothing is deprecated today. When something is, the operation will be marked `deprecated: true` in this spec, its responses will carry the `Deprecation` header (RFC 9745) and a `Sunset` header (RFC 8594) with the date the old behavior ends, and the change will be announced in the release notes at https://github.com/Cap-go/capgo.app/releases.


    ## Rate limits


    Each API key may send 2,000 requests per minute (20,000 per minute on bundle upload routes). Responses report the quota with the `RateLimit-Policy` and `RateLimit` headers (IETF draft-ietf-httpapi-ratelimit-headers), for example `RateLimit-Policy: "apikey";q=2000;w=60` and `RateLimit: "apikey";r=1995;t=42` (r = requests left, t = seconds until the window resets). An IP address that sends 20 invalid keys within 15 minutes is blocked for 15 minutes. A 429 response includes `Retry-After` in seconds.


    ## Errors


    Every error response is JSON with a machine-readable `error` code, a human-readable `message`, and optional `moreInfo` details, for example `{"error":"invalid_apikey","message":"Invalid apikey","moreInfo":{}}`.'
  version: '2025-10-01'
servers:
- url: https://api.capgo.app
  description: Production
security:
- CapgoApiKeyAuth: []
- CapgoBearerAuth: []
- CapgoOAuth:
  - capgo
- CapgoLegacyAuthorization: []
tags:
- name: Channels
  description: Live update rollout channels.
paths:
  /channel/:
    get:
      tags:
      - Channels
      operationId: listChannels
      summary: List channels for one app
      parameters:
      - name: app_id
        in: query
        required: true
        schema:
          type: string
      - $ref: '#/components/parameters/PageParam'
      - name: channel
        in: query
        description: Optional channel name filter.
        schema:
          type: string
      - $ref: '#/components/parameters/CapgoApiVersion'
      responses:
        '200':
          description: Channels.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChannelListEnvelope'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '401':
          description: The API key is missing, invalid, or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '403':
          description: The API key is valid but lacks the required scope or org access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '429':
          description: Too many requests. Back off and retry later.
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
            Retry-After:
              $ref: '#/components/headers/Retry-After'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Unexpected Capgo server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        default:
          description: Any other error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      description: List live-update channels for one app, including the current bundle assignment and rollout flags.
    post:
      tags:
      - Channels
      operationId: upsertChannel
      summary: Create or update a channel configuration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChannelSet'
      responses:
        '200':
          description: Channel accepted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '400':
          description: The request body or query parameters were invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '401':
          description: The API key is missing, invalid, or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '403':
          description: The API key is valid but lacks the required scope or org access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '429':
          description: Too many requests. Back off and retry later.
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
            Retry-After:
              $ref: '#/components/headers/Retry-After'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Unexpected Capgo server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        default:
          description: Any other error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      description: 'Create or update a channel configuration: default bundle, public/private access, disable auto-update, and rollout policy.'
      parameters:
      - $ref: '#/components/parameters/CapgoApiVersion'
    delete:
      tags:
      - Channels
      operationId: deleteChannel
      summary: Delete one channel
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ChannelDelete'
      responses:
        '200':
          description: Channel deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '400':
          description: The request body or query parameters were invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '401':
          description: The API key is missing, invalid, or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '403':
          description: The API key is valid but lacks the required scope or org access.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        '429':
          description: Too many requests. Back off and retry later.
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
            Retry-After:
              $ref: '#/components/headers/Retry-After'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Unexpected Capgo server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimit-Policy'
        default:
          description: Any other error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      description: Delete one channel from an app. Devices on that channel fall back according to app defaults after deletion.
      parameters:
      - $ref: '#/components/parameters/CapgoApiVersion'
components:
  headers:
    Retry-After:
      description: Seconds to wait before retrying.
      schema:
        type: integer
    RateLimit-Policy:
      description: 'Quota policy (draft-ietf-httpapi-ratelimit-headers): `"<policy>";q=<requests>;w=<window seconds>`.'
      schema:
        type: string
      example: '"apikey";q=2000;w=60'
    RateLimit:
      description: 'Remaining quota for the current window (draft-ietf-httpapi-ratelimit-headers): `"<policy>";r=<requests left>;t=<seconds until reset>`.'
      schema:
        type: string
      example: '"apikey";r=1995;t=42'
  schemas:
    ChannelVersion:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
      required:
      - id
      - name
    StatusResponse:
      type: object
      properties:
        status:
          type: string
      required:
      - status
      additionalProperties: true
    ErrorResponse:
      type: object
      description: Error body returned by every 4xx and 5xx response.
      properties:
        error:
          type: string
          description: Machine-readable error code, for example `invalid_apikey`, `no_key_provided`, `too_many_requests`.
        message:
          type: string
          description: Human-readable explanation.
        moreInfo:
          type: object
          description: Optional structured details, such as `retryAfterSeconds` on a 429.
          additionalProperties: true
      required:
      - error
      - message
      additionalProperties: true
    ChannelDelete:
      type: object
      additionalProperties: false
      properties:
        app_id:
          type: string
        channel:
          type: string
      required:
      - app_id
      - channel
    Channel:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        app_id:
          type: string
        version:
          $ref: '#/components/schemas/ChannelVersion'
        public:
          type: boolean
        disableAutoUpdateUnderNative:
          type: boolean
        disableAutoUpdate:
          type:
          - string
          - boolean
        allow_emulator:
          type: boolean
        allow_dev:
          type: boolean
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
      required:
      - id
      - name
      - app_id
    ChannelSet:
      type: object
      additionalProperties: false
      properties:
        app_id:
          type: string
        channel:
          type: string
        version:
          type: string
        public:
          type: boolean
        disableAutoUpdateUnderNative:
          type: boolean
        disableAutoUpdate:
          type: string
          enum:
          - major
          - minor
          - version_number
          - none
        ios:
          type: boolean
        android:
          type: boolean
        electron:
          type: boolean
        allow_device_self_set:
          type: boolean
        allow_emulator:
          type: boolean
        allow_dev:
          type: boolean
      required:
      - app_id
      - channel
    ChannelListEnvelope:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Channel'
      required:
      - data
  parameters:
    CapgoApiVersion:
      name: capgo_api
      in: header
      required: false
      description: Date-based API version to pin. Defaults to the current version when omitted.
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2}$
        default: '2025-10-01'
      example: '2025-10-01'
    PageParam:
      name: page
      in: query
      schema:
        type: integer
        minimum: 0
  securitySchemes:
    CapgoApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Send the raw Capgo API key in the `x-api-key` header. Generate or rotate keys at https://console.capgo.app/settings/organization/api-keys.
    CapgoBearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Capgo API key
      description: 'Send a Capgo API key, or an access token from the Capgo OAuth flow, as `Authorization: Bearer <key>`.'
    CapgoOAuth:
      type: oauth2
      description: 'OAuth 2.0 authorization code flow with PKCE (S256) and dynamic client registration (https://api.capgo.app/mcp/oauth/register). Issuer: https://capgo.app. The access token is a Capgo API key limited to the organizations the user selects on the consent screen; send it as a Bearer token.'
      flows:
        authorizationCode:
          authorizationUrl: https://api.capgo.app/mcp/oauth/authorize
          tokenUrl: https://api.capgo.app/mcp/oauth/token
          scopes:
            capgo: Act on the organizations the user selects on the consent screen, with the user's role in each of them.
    CapgoLegacyAuthorization:
      type: apiKey
      in: header
      name: authorization
      description: Legacy raw API key in the `authorization` header without a Bearer prefix. Prefer `x-api-key`.
externalDocs:
  description: Capgo public API documentation
  url: https://capgo.app/docs/public-api/