# Vertesia Apps API

**Canonical:** https://apis.io/apis/vertesiahq/vertesiahq-apps-api/  
**Provider:** Vertesia — https://apis.io/providers/vertesiahq/  
**Base URL:** https://api.us1.vertesia.io/api/v1  
**Documentation:** https://vertesiahq.com/docs

Vertesia Apps API is one of 48 APIs that [Vertesia](https://apis.io/providers/vertesiahq/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Application. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

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

## Operations (52)

| Method | Path | Summary |
|---|---|---|
| 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 |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/vertesiahq/refs/heads/main/openapi/vertesiahq-apps-api-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vertesiahq/refs/heads/main/json-schema/vertesiahq-agent-run-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vertesiahq/refs/heads/main/json-schema/vertesiahq-update-app-payload-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vertesiahq/refs/heads/main/json-schema/vertesiahq-app-manifest-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vertesiahq/refs/heads/main/json-schema/vertesiahq-app-manifest-data-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vertesiahq/refs/heads/main/json-schema/vertesiahq-indexing-status-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vertesiahq/refs/heads/main/json-schema/vertesiahq-dashboard-schema.json

## Other Vertesia APIs (12)

- [Vertesia Access Control Entries API](https://apis.io/apis/vertesiahq/vertesiahq-access-control-entries-api/)
- [Vertesia Account API](https://apis.io/apis/vertesiahq/vertesiahq-account-api/)
- [Vertesia Accounts API](https://apis.io/apis/vertesiahq/vertesiahq-accounts-api/)
- [Vertesia Agent Runs API](https://apis.io/apis/vertesiahq/vertesiahq-agent-runs-api/)
- [Vertesia API Keys API](https://apis.io/apis/vertesiahq/vertesiahq-api-keys-api/)
- [Vertesia Audit Trail API](https://apis.io/apis/vertesiahq/vertesiahq-audit-trail-api/)
- [Vertesia Bulk Operations API](https://apis.io/apis/vertesiahq/vertesiahq-bulk-operations-api/)
- [Vertesia Collections API](https://apis.io/apis/vertesiahq/vertesiahq-collections-api/)
- [Vertesia Commands API](https://apis.io/apis/vertesiahq/vertesiahq-commands-api/)
- [Vertesia Content Object Types API](https://apis.io/apis/vertesiahq/vertesiahq-content-object-types-api/)
- [Vertesia Content Query API](https://apis.io/apis/vertesiahq/vertesiahq-content-query-api/)
- [Vertesia Costs API](https://apis.io/apis/vertesiahq/vertesiahq-costs-api/)

## Tags

Application

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/vertesiahq/vertesiahq-apps-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/vertesiahq/.