Continue

Continue Ide API

The Ide API from Continue — 8 operation(s) for ide.

GitHub OpenAPI

Operations 8

GET /ide/list-assistants List Assistants for IDE #
GET /ide/get-assistant/{ownerSlug}/{packageSlug} Get a Specific Assistant by Slug #
GET /ide/free-trial-status Get Free Trial Status for User #
GET /ide/get-models-add-on-checkout-url Get Stripe Checkout URL for Models Add-On #
GET /ide/policy Get Organization Policy #
POST /ide/sync-secrets Synchronize Secrets for User #
GET /ide/list-assistant-full-slugs List Assistant Full Slugs #
GET /ide/list-organizations List Organizations for User #

Documentation

📖
Documentation
https://github.com/continuedev/continue/tree/main/packages/continue-sdk

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/continue-dev/refs/heads/main/openapi/continue-dev-ide-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/continue-dev/refs/heads/main/json-schema/continue-dev-assistant-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/continue-dev/refs/heads/main/json-schema/continue-dev-organization-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/continue-dev/refs/heads/main/json-schema/continue-dev-free-trial-status-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/continue-dev/refs/heads/main/json-structure/continue-dev-assistant-structure.json

Other Resources

🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/continue-dev/refs/heads/main/json-ld/continue-dev-context.jsonld
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/continue-dev/refs/heads/main/examples/continue-dev-list-assistants-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/continue-dev/refs/heads/main/examples/continue-dev-list-organizations-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/continue-dev/refs/heads/main/examples/continue-dev-free-trial-status-example.json
🔗
SDKs
https://www.npmjs.com/package/@continuedev/sdk
🔗
SDKs
https://pypi.org/project/continuedev-sdk/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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/continue-dev-ide-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

continue-dev-ide-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Continue Hub Ide API
  description: 'API for Continue IDE to fetch assistants and other related information.

    These endpoints are primarily used by the Continue IDE extensions for VS Code and JetBrains.

    '
  version: 1.0.0
  contact:
    name: Continue Dev Team
    url: https://continue.dev
servers:
- url: https://api.continue.dev
  description: Production server
- url: http://localhost:3001
  description: Local development server
tags:
- name: Ide
paths:
  /ide/list-assistants:
    get:
      summary: List Assistants for IDE
      description: 'Returns a complete list of assistants available to the user, with their full configurations,

        icons, and other metadata needed by the IDE to display and use them.


        This endpoint performs a full refresh of the list of assistants, including unrolling

        configurations and resolving secrets.

        '
      operationId: listAssistants
      parameters:
      - name: alwaysUseProxy
        in: query
        description: Whether to always use the Continue-managed proxy for model requests
        required: false
        schema:
          type: string
          enum:
          - 'true'
          - 'false'
      - name: organizationId
        in: query
        description: ID of the organization to scope assistants to. If not provided, personal assistants are returned.
        required: false
        schema:
          type: string
      security:
      - apiKeyAuth: []
      responses:
        '200':
          description: Successfully retrieved assistants
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  required:
                  - configResult
                  - ownerSlug
                  - packageSlug
                  properties:
                    configResult:
                      type: object
                      required:
                      - config
                      - configLoadInterrupted
                      properties:
                        config:
                          type:
                          - object
                          - 'null'
                          description: The unrolled assistant configuration
                        configLoadInterrupted:
                          type: boolean
                          description: Whether the configuration loading was interrupted
                        errors:
                          type:
                          - array
                          - 'null'
                          items:
                            type: string
                          description: Any errors that occurred during configuration loading
                    ownerSlug:
                      type: string
                      description: Slug of the user or organization that owns the assistant
                    packageSlug:
                      type: string
                      description: Slug of the assistant package
                    iconUrl:
                      type:
                      - string
                      - 'null'
                      description: Pre-signed URL for the assistant's icon
                    onPremProxyUrl:
                      type:
                      - string
                      - 'null'
                      description: URL of the on-premises proxy if the organization uses one
                    useOnPremProxy:
                      type:
                      - boolean
                      - 'null'
                      description: Whether the organization uses an on-premises proxy
                    rawYaml:
                      type: string
                      description: Raw YAML configuration of the assistant
        '401':
          description: Unauthorized - Authentication failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Unauthorized
        '404':
          description: User not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: User not found
      tags:
      - Ide
  /ide/get-assistant/{ownerSlug}/{packageSlug}:
    get:
      summary: Get a Specific Assistant by Slug
      description: 'Returns a single assistant configuration by its owner and package slug.

        This endpoint is useful when you need to retrieve or refresh a specific assistant

        without fetching the entire list.

        '
      operationId: getAssistant
      parameters:
      - name: ownerSlug
        in: path
        description: Slug of the user or organization that owns the assistant
        required: true
        schema:
          type: string
      - name: packageSlug
        in: path
        description: Slug of the assistant package
        required: true
        schema:
          type: string
      - name: alwaysUseProxy
        in: query
        description: Whether to always use the Continue-managed proxy for model requests
        required: false
        schema:
          type: string
          enum:
          - 'true'
          - 'false'
      - name: organizationId
        in: query
        description: ID of the organization to scope assistants to. If not provided, personal assistants are returned.
        required: false
        schema:
          type: string
      security:
      - apiKeyAuth: []
      responses:
        '200':
          description: Successfully retrieved assistant
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                required:
                - configResult
                - ownerSlug
                - packageSlug
                properties:
                  configResult:
                    type: object
                    required:
                    - config
                    - configLoadInterrupted
                    properties:
                      config:
                        type:
                        - object
                        - 'null'
                        description: The unrolled assistant configuration
                      configLoadInterrupted:
                        type: boolean
                        description: Whether the configuration loading was interrupted
                      errors:
                        type:
                        - array
                        - 'null'
                        items:
                          type: string
                        description: Any errors that occurred during configuration loading
                  ownerSlug:
                    type: string
                    description: Slug of the user or organization that owns the assistant
                  packageSlug:
                    type: string
                    description: Slug of the assistant package
                  iconUrl:
                    type:
                    - string
                    - 'null'
                    description: Pre-signed URL for the assistant's icon
                  onPremProxyUrl:
                    type:
                    - string
                    - 'null'
                    description: URL of the on-premises proxy if the organization uses one
                  useOnPremProxy:
                    type:
                    - boolean
                    - 'null'
                    description: Whether the organization uses an on-premises proxy
                  rawYaml:
                    type: string
                    description: Raw YAML configuration of the assistant
        '401':
          description: Unauthorized - Authentication failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Unauthorized
        '403':
          description: Forbidden - Assistant not allowed in organization
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: This assistant is not allowed in this organization
        '404':
          description: User or assistant not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Assistant not found
      tags:
      - Ide
  /ide/free-trial-status:
    get:
      summary: Get Free Trial Status for User
      description: 'Returns the current free trial status for the authenticated user, including

        usage counts and limits for chat and autocomplete features.

        '
      operationId: getFreeTrialStatus
      security:
      - apiKeyAuth: []
      responses:
        '200':
          description: Successfully retrieved free trial status
          content:
            application/json:
              schema:
                type: object
                required:
                - optedInToFreeTrial
                - chatLimit
                - autocompleteLimit
                properties:
                  optedInToFreeTrial:
                    type: boolean
                    description: Whether the user has opted into the free trial
                  chatCount:
                    type:
                    - number
                    - 'null'
                    description: Current number of chat messages used
                  autocompleteCount:
                    type:
                    - number
                    - 'null'
                    description: Current number of autocomplete requests used
                  chatLimit:
                    type: number
                    description: Maximum number of chat messages allowed in free trial
                  autocompleteLimit:
                    type: number
                    description: Maximum number of autocomplete requests allowed in free trial
        '404':
          description: User not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: User not found
      tags:
      - Ide
  /ide/get-models-add-on-checkout-url:
    get:
      summary: Get Stripe Checkout URL for Models Add-On
      description: 'Creates a Stripe checkout session for the models add-on subscription

        and returns the checkout URL.

        '
      operationId: getModelsAddOnCheckoutUrl
      parameters:
      - name: profile_id
        in: query
        description: Profile ID to include in the callback URL
        required: false
        schema:
          type: string
      - name: vscode_uri_scheme
        in: query
        description: VS Code URI scheme to include in the callback URL
        required: false
        schema:
          type: string
      security:
      - apiKeyAuth: []
      responses:
        '200':
          description: Successfully created checkout session
          content:
            application/json:
              schema:
                type: object
                required:
                - url
                properties:
                  url:
                    type: string
                    description: Stripe checkout session URL
        '404':
          description: User not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: User not found
        '500':
          description: Failed to create checkout session
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Failed to create checkout session
      tags:
      - Ide
  /ide/policy:
    get:
      summary: Get Organization Policy
      description: 'Returns the policy configuration for the first organization

        that the user belongs to which has a policy configured.

        '
      operationId: getPolicy
      security:
      - apiKeyAuth: []
      responses:
        '200':
          description: Successfully retrieved policy
          content:
            application/json:
              schema:
                type: object
                properties:
                  policy:
                    type:
                    - object
                    - 'null'
                    description: Organization policy configuration
                  orgSlug:
                    type:
                    - string
                    - 'null'
                    description: Slug of the organization that has the policy
        '404':
          description: User not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: User not found
      tags:
      - Ide
  /ide/sync-secrets:
    post:
      summary: Synchronize Secrets for User
      description: 'Resolves and synchronizes secrets for the authenticated user based on

        the provided Fully Qualified Secret Names (FQSNs).

        '
      operationId: syncSecrets
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - fqsns
              properties:
                fqsns:
                  type: array
                  items:
                    type: object
                  description: Array of Fully Qualified Secret Names to resolve
                orgScopeId:
                  type:
                  - string
                  - 'null'
                  description: Organization ID to scope secret resolution to
                orgScopeSlug:
                  type:
                  - string
                  - 'null'
                  description: Organization slug to scope secret resolution to
      security:
      - apiKeyAuth: []
      responses:
        '200':
          description: Successfully resolved secrets
          content:
            application/json:
              schema:
                type: array
                items:
                  type:
                  - object
                  - 'null'
                  description: Resolved secret result or undefined if not found
        '404':
          description: User not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: User not found
      tags:
      - Ide
  /ide/list-assistant-full-slugs:
    get:
      summary: List Assistant Full Slugs
      description: 'This endpoint is temporarily disabled and returns a 429 status code

        to prevent constant refreshes of the full assistant list until a

        fixed client version can be deployed.

        '
      operationId: listAssistantFullSlugs
      security:
      - apiKeyAuth: []
      responses:
        '429':
          description: Too many requests - endpoint temporarily disabled
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Too many requests
      tags:
      - Ide
  /ide/list-organizations:
    get:
      summary: List Organizations for User
      description: 'Returns a list of organizations that the authenticated user belongs to,

        including organization metadata and pre-signed icon URLs.

        '
      operationId: listOrganizations
      security:
      - apiKeyAuth: []
      responses:
        '200':
          description: Successfully retrieved organizations
          content:
            application/json:
              schema:
                type: object
                required:
                - organizations
                properties:
                  organizations:
                    type: array
                    items:
                      type: object
                      required:
                      - id
                      - name
                      - slug
                      properties:
                        id:
                          type: string
                          description: Organization ID
                        name:
                          type: string
                          description: Organization name
                        iconUrl:
                          type:
                          - string
                          - 'null'
                          description: Pre-signed URL for the organization's icon
                        slug:
                          type: string
                          description: Organization slug
        '404':
          description: User not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: User not found
      tags:
      - Ide
components:
  securitySchemes:
    apiKeyAuth:
      type: http
      scheme: bearer
      description: 'API Key Authentication


        API keys must be prefixed with "con_" and provided in the Authorization header.

        Example: `Authorization: Bearer con_your_api_key_here`


        API keys can be generated in the Continue Hub web interface under account settings.

        '