Vertesia

Vertesia Apps API

App endpoints manage app manifests, project installations, installation settings, and installation-scoped tool visibility.

GitHub OpenAPI

Operations 52

GET /apps/source-providers/github Get App Builder GitHub provider configuration #
POST /apps/source-providers/github/authorize Start GitHub authorization for an App Builder source #
POST /apps/source-providers/github/exchange Verify GitHub App installations visible to the current user #
GET /apps/source-providers/github/repositories List repositories accessible to a verified GitHub App installation #
GET /apps/source-providers/github/repository-setup Inspect branches in a verified GitHub repository #
GET /apps/instance-availability Check whether additional MCP app instances are enabled for this project #
GET /apps/{id}/repo/tree List files in the app git repository #
GET /apps/{id}/repo/file Read a file from the app git repository #
POST /apps/{id}/repo/documents Commit documents to the app git repository #
GET /apps/{id}/repo/commits List commits in the app git repository #
GET /apps/{id}/repo/refs List branches and tags in the app git repository #
GET /apps/{id}/development-tasks List app development tasks #
GET /apps/{id}/development-tasks/{taskId} Get an app development task #
POST /apps/{id}/development-tasks/{taskId}/runs Start an app development task run #
POST /apps/{id}/repo/branches Create a branch in the app git repository #
PUT /apps/installations/{installId}/collections/{collectionId}/api-key Set an installation MCP API key #
GET /apps/installations/{installId}/collections/{collectionId}/api-key Read an installation MCP API key status #
DELETE /apps/installations/{installId}/collections/{collectionId}/api-key Delete an installation MCP API key #
PUT /apps/{id}/collections/{collectionId}/api-key Set the API key of an MCP tool collection #
GET /apps/{id}/collections/{collectionId}/api-key Check whether an MCP tool collection has an API key #
DELETE /apps/{id}/collections/{collectionId}/api-key Delete the API key of an MCP tool collection #
GET /apps/{id}/package Get an app package by scope #
GET /apps/versions List app versions #
POST /apps/versions Record an app version #
GET /apps/versions/{id} Get an app version #
DELETE /apps/versions/{id} Delete an app version #
POST /apps/versions/{id}/promote Promote an app version #
POST /apps/versions/{id}/rebuild Rebuild an app version #
POST /apps/scaffolds Start an app scaffold #
GET /apps/scaffolds/{workflowId}/{runId}/progress Get app scaffold progress #
POST /apps/{id}/builds Start an app build #
GET /apps/{id}/builds/{workflowId}/{runId}/progress Get app build progress #
POST /apps Create an app #
GET /apps List apps #
PUT /apps/{id} Update an app #
DELETE /apps/{id} Delete an app #
POST /apps/install Install an app #
DELETE /apps/install/{installId} Uninstall an app #
GET /apps/installations/name/{name} Retrieve an app installation by app name #
GET /apps/installations/projects List projects for an app installation #
GET /apps/installations/{installId}/tools List tools for an app installation #
GET /apps/installations/{installId}/package Get an app installation package #
GET /apps/{id}/inspect Inspect an app registration #
GET /apps/installations List app installations #
GET /apps/installations/id/{installId} Retrieve an authorized app installation by ID #
GET /apps/installations/all List all app installations #
GET /apps/installations/refs List app installation references #
GET /apps/installations/projects/{appName} Get projects for an installed app #
PUT /apps/installations/settings/{app_id} Update app installation settings #
PUT /apps/installations/{installId}/oauth-approval Approve or revoke OAuth permissions for an app installation #
PUT /apps/installations/{installId}/tool-allowlist Update app installation tool allowlist #
POST /apps/validate-url Validate an app URL #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/vertesiahq/openapi/vertesiahq-apps-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/vertesiahq/json-schema/vertesiahq-update-app-payload-schema.json
📊
JSONSchema
https://artifacts.apis.io/vertesiahq/json-schema/vertesiahq-app-manifest-schema.json
📊
JSONSchema
https://artifacts.apis.io/vertesiahq/json-schema/vertesiahq-app-manifest-data-schema.json

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/vertesiahq:vertesiahq-apps-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

vertesiahq-apps-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Vertesia Apps API
  version: 1.6.0-dev.20261019.172735Z
  x-api-version: '20260803'
  description: The Vertesia API provides project-scoped access to interaction execution and content workflows. Use it to run interactions, inspect execution history, stream run progress, replay previous executions, and search content objects and collections. Authenticate requests with a bearer token, or use the official `@vertesia/client` package for typed access from Node.js applications.
  contact:
    name: Vertesia
    url: https://vertesiahq.com/
  license:
    name: Apache-2.0
    identifier: Apache-2.0
  x-scalar-sdk-installation:
  - lang: Node
    description: 'Install the **Vertesia Client** from npm:'
    source: npm install @vertesia/client
servers:
- url: https://api.{region}.vertesia.io/api/v1
  description: Vertesia API
  variables:
    region:
      default: us1
      enum:
      - us1
      - eu1
      - jp1
      description: Regional API host label. `us1` is the global endpoint.
tags:


# --- truncated at 32 KB (365 KB total) ---
# Full source: https://artifacts.apis.io/vertesiahq/openapi/vertesiahq-apps-api-openapi.yml