# Open VSX

> Search the Open VSX Registry, where VSCodium, Cursor, Gitpod, Theia and other editors get their VS Code extensions. Read an extension's versions, platform builds, download links and checksums, README, changelog and manifest, check which version works with a given VS Code, read reviews and namespaces, and follow the registry's feed of published and removed versions. A trigger runs a workflow when an extension publishes a new version. No account or API key required.

App · 12 actions. Web page: https://docs.lodol.com/docs/integrations/open-vsx

## Actions

### Check VS Code compatibility

Find the newest version of an extension that works with a given VS Code version, using VS Code's own rule for the versions an extension says it needs. For editors built on an older VS Code, such as an outdated VSCodium, it says which version to install and gives its download link. No API key required.

**Inputs**

- Extension (`extension`, text, required): The extension's ID: its namespace and name joined by a dot, such as 'redhat.java'. 'redhat/java', a link to its open-vsx.org page or a link to its VS Code Marketplace page work too.
- VS Code version (`vscode_version`, text, required): The VS Code version to check against, such as 1.95.3. For VSCodium, Cursor, Windsurf or Theia, give the VS Code version the editor is built on, which its About window shows.
- Platform (`target_platform`, text): Check this platform's builds. Leave empty for the universal build, or the extension's main build when it has no universal one. One of: `universal` (Universal (runs anywhere)), `web` (Web (runs in a browser)), `win32-x64` (Windows x64), `win32-arm64` (Windows ARM64), `win32-ia32` (Windows 32-bit), `linux-x64` (Linux x64), `linux-arm64` (Linux ARM64), `linux-armhf` (Linux ARM 32-bit), `alpine-x64` (Alpine Linux x64), `alpine-arm64` (Alpine Linux ARM64), `darwin-x64` (macOS Intel), `darwin-arm64` (macOS Apple silicon).
- Include pre-releases (`include_pre_releases`, true/false): Also consider pre-release versions. Off by default, as editors install pre-releases only for people who opt in. Default: `false`.

**Outputs**

- `compatible` (true/false): True when a version was found that works with that VS Code version.
- `compatible_download_url` (text): The link to download that version.
- `compatible_engine` (text): The VS Code requirement of that version, such as '^1.65.0'.
- `compatible_pre_release` (true/false): Whether that version is a pre-release.
- `compatible_published_at` (text): When that version was published.
- `compatible_version` (text): The newest version that works with it, or null when none does.
- `display_name` (text): The name people see, such as 'Language Support for Java(TM) by Red Hat'.
- `extension` (text): The extension's ID, its namespace and name joined by a dot, such as 'redhat.java'. Every action that takes an extension accepts it.
- `include_pre_releases` (true/false): Whether pre-releases were considered.
- `latest_engine` (text): The VS Code requirement of the newest version.
- `latest_is_compatible` (true/false): True when the newest version itself works, so nothing older is needed.
- `latest_version` (text): The newest version checked: the newest stable one unless pre-releases are included.
- `target_platform` (text): The platform whose builds were checked.
- `unreadable_requirements` (number): How many of them state their VS Code requirement in a form VS Code itself can't read, so they were passed over.
- `versions_checked` (number): How many versions were checked, newest first, to find the answer.
- `vscode_version` (text): The VS Code version checked, such as '1.95.3'.

**Example output**

```json
{
  "compatible": true,
  "compatible_download_url": "https://open-vsx.org/api/redhat/java/1.15.0/file/redhat.java-1.15.0.vsix",
  "compatible_engine": "^1.65.0",
  "compatible_pre_release": false,
  "compatible_published_at": "2023-02-20T15:05:15.009972Z",
  "compatible_version": "1.15.0",
  "display_name": "Language Support for Java(TM) by Red Hat",
  "extension": "redhat.java",
  "include_pre_releases": false,
  "latest_engine": "^1.77.0",
  "latest_is_compatible": false,
  "latest_version": "1.58.0",
  "target_platform": "universal",
  "unreadable_requirements": 0,
  "versions_checked": 48,
  "vscode_version": "1.70.0"
}
```

### Find extension builds

List the builds Open VSX holds for one extension or for every extension in a namespace: one row per extension and platform, with its version, the VS Code versions it needs and its download link. Narrow to a version or a platform, or include every older version too. No API key required.

**Inputs**

- Extension (`extension`, text): The extension whose builds to list, by ID such as 'redhat.java' or by link. Leave empty to list a whole namespace instead.
- Namespace (`namespace`, text): The namespace whose extensions' builds to list, such as 'redhat', when no extension is given.
- Version (`version`, text): Only builds of this version, such as '1.58.0'. Leave empty for each build's newest version.
- Platform (`target_platform`, text): Only builds for this platform. Universal builds count only under Universal. Leave empty for every platform. One of: `universal` (Universal (runs anywhere)), `web` (Web (runs in a browser)), `win32-x64` (Windows x64), `win32-arm64` (Windows ARM64), `win32-ia32` (Windows 32-bit), `linux-x64` (Linux x64), `linux-arm64` (Linux ARM64), `linux-armhf` (Linux ARM 32-bit), `alpine-x64` (Alpine Linux x64), `alpine-arm64` (Alpine Linux ARM64), `darwin-x64` (macOS Intel), `darwin-arm64` (macOS Apple silicon).
- Every older version too (`all_versions`, true/false): List every version of every build, not only the newest. Ignored when a version is given. Default: `false`.
- How many per page (`limit`, number): How many builds to return, up to 100. From 1 to 100. Default: `50`.
- Page (`page`, number): Which page of results to read: 1 for the first. At least 1. Default: `1`.

**Outputs**

- `builds` (list): The builds: one per extension, version and platform.
- `count` (number): How many builds are on this page.
- `extension` (text): The extension whose builds are listed, or null.
- `more_available` (true/false): True when there are more results after this page.
- `namespace` (text): The namespace whose builds are listed, or null.
- `page` (number): The page of results this is, from 1.
- `total_matching` (number): How many builds match in all.

**Example output**

```json
{
  "builds": [
    {
      "display_name": "Language Support for Java(TM) by Red Hat",
      "download_url": "https://open-vsx.org/api/redhat/java/1.58.0/file/redhat.java-1.58.0.vsix",
      "id": "redhat.java",
      "name": "java",
      "namespace": "redhat",
      "pre_release": false,
      "published_at": "2026-10-19T12:35:57.861596Z",
      "target_platform": "universal",
      "url": "https://open-vsx.org/extension/redhat/java/1.58.0",
      "version": "1.58.0",
      "vscode_engine": "^1.77.0"
    },
    {
      "display_name": "Language Support for Java(TM) by Red Hat",
      "download_url": "https://open-vsx.org/api/redhat/java/darwin-arm64/1.58.0/file/redhat.java-1.58.0@darwin-arm64.vsix",
      "id": "redhat.java",
      "name": "java",
      "namespace": "redhat",
      "pre_release": false,
      "published_at": "2026-10-19T12:35:26.381960Z",
      "target_platform": "darwin-arm64",
      "url": "https://open-vsx.org/extension/redhat/java/darwin-arm64/1.58.0",
      "version": "1.58.0",
      "vscode_engine": "^1.77.0"
    }
  ],
  "count": 2,
  "extension": "redhat.java",
  "more_available": true,
  "namespace": null,
  "page": 1,
  "total_matching": 7
}
```

### Get a namespace

Get a namespace (the publisher part of an extension ID, such as 'redhat'): its name, description, website and whether it is verified, and every extension it publishes with its downloads and rating, most downloaded first. No API key required.

**Inputs**

- Namespace (`namespace`, text, required): The namespace's name, the part before the dot in an extension ID (such as 'redhat' in 'redhat.java'), or its open-vsx.org link.

**Outputs**

- `description` (text): How its owners describe it, or null.
- `display_name` (text): Its display name, such as 'Red Hat'.
- `extension_count` (number): How many extensions it publishes.
- `extensions` (list): Its extensions, most downloaded first.
- `logo_url` (text): Its logo image, or null.
- `name` (text): The namespace's name, such as 'redhat'.
- `social_links` (list): Its social network profiles.
- `support_url` (text): Where to get support, or null.
- `total_downloads` (number): The downloads of all its extensions added up.
- `url` (text): Its page on open-vsx.org.
- `verified` (true/false): True when the namespace has an owner, so its publishers can be verified.
- `website_url` (text): Its website, or null.

**Example output**

```json
{
  "description": "Red Hat is the leading provider of enterprise open source software solutions",
  "display_name": "Red Hat",
  "extension_count": 2,
  "extensions": [
    {
      "average_rating": 5.0,
      "deprecated": false,
      "description": "Java Linting, Intellisense, formatting, refactoring, Maven/Gradle support and more...",
      "display_name": "Language Support for Java(TM) by Red Hat",
      "download_url": "https://open-vsx.org/api/redhat/java/1.59.2026102108/file/redhat.java-1.59.2026102108.vsix",
      "downloads": 46380453,
      "icon_url": "https://open-vsx.org/api/redhat/java/1.59.2026102108/file/icon128.png",
      "id": "redhat.java",
      "name": "java",
      "namespace": "redhat",
      "published_at": "2026-10-21T08:21:28.683632Z",
      "review_count": 16,
      "url": "https://open-vsx.org/extension/redhat/java",
      "verified": false,
      "version": "1.59.2026102108"
    },
    {
      "average_rating": 5.0,
      "deprecated": false,
      "description": "YAML Language Support by Red Hat, with built-in Kubernetes syntax support",
      "display_name": "YAML",
      "download_url": "https://open-vsx.org/api/redhat/vscode-yaml/2.1.2026102108/file/redhat.vscode-yaml-2.1.2026102108.vsix",
      "downloads": 8794234,
      "icon_url": "https://open-vsx.org/api/redhat/vscode-yaml/2.1.2026102108/file/icon128.png",
      "id": "redhat.vscode-yaml",
      "name": "vscode-yaml",
      "namespace": "redhat",
      "published_at": "2026-10-21T08:15:42.506126Z",
      "review_count": 8,
      "url": "https://open-vsx.org/extension/redhat/vscode-yaml",
      "verified": false,
      "version": "2.1.2026102108"
    }
  ],
  "logo_url": "https://openvsx.eclipsecontent.org/redhat/logo/logo-redhat-1735735314371.png",
  "name": "redhat",
  "social_links": [],
  "support_url": null,
  "total_downloads": 55174687,
  "url": "https://open-vsx.org/namespace/redhat",
  "verified": true,
  "website_url": "https://redhat.com"
}
```

### Get an extension

Get everything about one extension on Open VSX, its newest version or any other: description, categories, licence, the VS Code versions it needs, the extensions it depends on, downloads and rating, who published it, and the links to its README, changelog, manifest and every platform's download. No API key required.

**Inputs**

- Extension (`extension`, text, required): The extension's ID: its namespace and name joined by a dot, such as 'redhat.java'. 'redhat/java', a link to its open-vsx.org page or a link to its VS Code Marketplace page work too.
- Version (`version`, text): A version number such as '1.58.0'. Leave empty for the newest version, which may be a pre-release. The list offers the newest hundred; type any other version in.
- Platform (`target_platform`, text): The platform whose build to read. Most extensions have one universal build that runs anywhere, which is used when the extension has no build of its own for the platform chosen. Leave empty for the universal build, or the extension's main build when it has no universal one. One of: `universal` (Universal (runs anywhere)), `web` (Web (runs in a browser)), `win32-x64` (Windows x64), `win32-arm64` (Windows ARM64), `win32-ia32` (Windows 32-bit), `linux-x64` (Linux x64), `linux-arm64` (Linux ARM64), `linux-armhf` (Linux ARM 32-bit), `alpine-x64` (Alpine Linux x64), `alpine-arm64` (Alpine Linux ARM64), `darwin-x64` (macOS Intel), `darwin-arm64` (macOS Apple silicon).

**Outputs**

- `average_rating` (number): Its average review rating out of 5, or null when nobody has rated it.
- `bugs_url` (text): Where to report its bugs, or null.
- `bundled_extensions` (list): For an extension pack, the IDs of the extensions it installs.
- `categories` (list): Its categories, such as 'Programming Languages'.
- `changelog_url` (text): The link to its changelog file, or null.
- `dependencies` (list): The IDs of the extensions it needs installed alongside it.
- `deprecated` (true/false): True when its publisher has marked it deprecated.
- `description` (text): Its one-line description.
- `display_name` (text): The name people see, such as 'Language Support for Java(TM) by Red Hat'.
- `download_url` (text): The link to download this version's .vsix package. Downloading it counts as a download on Open VSX.
- `downloadable` (true/false): False when Open VSX doesn't offer it for download (it shows the page only).
- `downloads` (number): How many times it has been downloaded from Open VSX.
- `engines` (list): Every engine it declares a requirement for (VS Code, and sometimes Node.js).
- `extension_kind` (list): Where it runs in a remote setup: 'ui' (on the local machine), 'workspace' (on the remote machine) or 'web'.
- `homepage_url` (text): Its homepage, or null.
- `icon_url` (text): The link to its icon image, or null.
- `id` (text): The extension's ID, its namespace and name joined by a dot, such as 'redhat.java'. Every action that takes an extension accepts it.
- `license` (text): Its licence, usually an SPDX ID such as 'MIT' or 'EPL-2.0'.
- `license_url` (text): The link to its licence file, or null.
- `localized_languages` (list): The languages it is translated into.
- `manifest_url` (text): The link to its manifest (package.json).
- `name` (text): Its name within the namespace, such as 'java'.
- `namespace` (text): The namespace it is published under, usually its publisher, such as 'redhat'.
- `namespace_display_name` (text): The namespace's display name, such as 'Red Hat'.
- `platform_downloads` (list): Every platform this version has a build for, with its download link.
- `pre_release` (true/false): True when this version is a pre-release, which editors install only for people who opt in to pre-releases.
- `preview` (true/false): True when its publisher marks it a preview.
- `published_at` (text): When this version was published, as an ISO 8601 date and time.
- `published_by` (object): The account that published this version.
- `published_with_trusted_publishing` (true/false): True when this version was published straight from a build system with trusted publishing rather than with a personal token.
- `qna_url` (text): Its questions and answers page, or null.
- `readme_url` (text): The link to its README file, or null.
- `replacement_id` (text): For a deprecated extension, the ID of the one its publisher recommends instead, or null.
- `replacement_name` (text): For a deprecated extension, the name of its recommended replacement.
- `replacement_url` (text): For a deprecated extension, the open-vsx.org page of its replacement.
- `repository_url` (text): Its source repository, or null.
- `review_count` (number): How many reviews it has on Open VSX.
- `sha256_url` (text): The link to the SHA-256 checksum of its package.
- `signature_url` (text): The link to the signature Open VSX made of its package, or null.
- `sponsor_url` (text): Where to sponsor its authors, or null.
- `tags` (list): The tags its publisher gave it, for search.
- `target_platform` (text): The platform this build is for: 'universal' for one build that runs anywhere, or one such as 'linux-x64', 'win32-x64' or 'darwin-arm64'.
- `url` (text): Its page on open-vsx.org.
- `verified` (true/false): True when the publisher is a verified member of the namespace, which the registry shows with a check mark.
- `version` (text): The version number, such as '1.58.0'.
- `version_aliases` (list): The names this version also goes by: 'latest' for the newest version and 'pre-release' for the newest pre-release.
- `version_url` (text): This version's page on open-vsx.org.
- `vscode_engine` (text): The VS Code versions it needs, in VS Code's own range syntax, such as '^1.77.0' (1.77.0 or later in 1.x).

**Example output**

```json
{
  "average_rating": 5.0,
  "bugs_url": "https://github.com/redhat-developer/vscode-java/issues",
  "bundled_extensions": [],
  "categories": [
    "Programming Languages",
    "Linters",
    "Formatters"
  ],
  "changelog_url": "https://open-vsx.org/api/redhat/java/1.58.0/file/changelog.md",
  "dependencies": [],
  "deprecated": false,
  "description": "Java Linting, Intellisense, formatting, refactoring, Maven/Gradle support and more...",
  "display_name": "Language Support for Java(TM) by Red Hat",
  "download_url": "https://open-vsx.org/api/redhat/java/1.58.0/file/redhat.java-1.58.0.vsix",
  "downloadable": true,
  "downloads": 46380453,
  "engines": [
    {
      "engine": "vscode",
      "range": "^1.77.0"
    }
  ],
  "extension_kind": [
    "workspace"
  ],
  "homepage_url": "https://github.com/redhat-developer/vscode-java#readme",
  "icon_url": "https://open-vsx.org/api/redhat/java/1.58.0/file/icon128.png",
  "id": "redhat.java",
  "license": "EPL-2.0",
  "license_url": "https://open-vsx.org/api/redhat/java/1.58.0/file/LICENSE.txt",
  "localized_languages": [],
  "manifest_url": "https://open-vsx.org/api/redhat/java/1.58.0/file/package.json",
  "name": "java",
  "namespace": "redhat",
  "namespace_display_name": "Red Hat",
  "platform_downloads": [
    {
      "download_url": "https://open-vsx.org/api/redhat/java/1.58.0/file/redhat.java-1.58.0.vsix",
      "target_platform": "universal"
    },
    {
      "download_url": "https://open-vsx.org/api/redhat/java/win32-x64/1.58.0/file/redhat.java-1.58.0@win32-x64.vsix",
      "target_platform": "win32-x64"
    },
    {
      "download_url": "https://open-vsx.org/api/redhat/java/win32-arm64/1.58.0/file/redhat.java-1.58.0@win32-arm64.vsix",
      "target_platform": "win32-arm64"
    }
  ],
  "pre_release": false,
  "preview": false,
  "published_at": "2026-10-19T12:35:57.861596Z",
  "published_by": {
    "avatar_url": "https://avatars.githubusercontent.com/u/18214726?v=4",
    "full_name": "Red Hat Developers CI",
    "homepage_url": "https://github.com/rhdevelopers-ci",
    "login_name": "rhdevelopers-ci",
    "provider": "github"
  },
  "published_with_trusted_publishing": false,
  "qna_url": null,
  "readme_url": "https://open-vsx.org/api/redhat/java/1.58.0/file/readme.md",
  "replacement_id": null,
  "replacement_name": null,
  "replacement_url": null,
  "repository_url": "https://github.com/redhat-developer/vscode-java.git",
  "review_count": 16,
  "sha256_url": "https://open-vsx.org/api/redhat/java/1.58.0/file/redhat.java-1.58.0.sha256",
  "signature_url": "https://open-vsx.org/api/redhat/java/1.58.0/file/redhat.java-1.58.0.sigzip",
  "sponsor_url": null,
  "tags": [
    "gradle-kotlin-dsl",
    "GradleKotlinDSL",
    "java"
  ],
  "target_platform": "universal",
  "url": "https://open-vsx.org/extension/redhat/java",
  "verified": true,
  "version": "1.58.0",
  "version_aliases": [],
  "version_url": "https://open-vsx.org/extension/redhat/java/1.58.0",
  "vscode_engine": "^1.77.0"
}
```

### Get an extension's manifest

Read an extension's manifest (its package.json) for its newest version or any other: the VS Code versions it needs, what makes the editor start it, whether it runs in the browser or in an untrusted folder, the commands, languages and settings it adds, and the extensions and npm packages it depends on. No API key required.

**Inputs**

- Extension (`extension`, text, required): The extension's ID: its namespace and name joined by a dot, such as 'redhat.java'. 'redhat/java', a link to its open-vsx.org page or a link to its VS Code Marketplace page work too.
- Version (`version`, text): A version number such as '1.58.0'. Leave empty for the newest version, which may be a pre-release. The list offers the newest hundred; type any other version in.

**Outputs**

- `activation_events` (list): What makes the editor start it, such as 'onLanguage:java' or 'workspaceContains:pom.xml'. Empty means only its contributions.
- `browser_entry` (text): The script it starts from in browser editors, or null when it has none.
- `categories` (list): The categories the manifest lists.
- `commands` (list): The commands it adds to the command palette.
- `contributes` (list): Each kind of thing it adds to the editor, such as commands, languages or themes, with how many.
- `description` (text): Its one-line description.
- `display_name` (text): The name people see, such as 'Language Support for Java(TM) by Red Hat'.
- `engines` (list): Every engine it declares a requirement for (VS Code, and sometimes Node.js).
- `extension_dependencies` (list): The IDs of the extensions it needs installed.
- `extension_kind` (list): Where it prefers to run in a remote setup: 'ui', 'workspace' or 'web'. Empty means the editor decides.
- `extension_pack` (list): For an extension pack, the IDs it installs.
- `id` (text): The extension's ID, its namespace and name joined by a dot, such as 'redhat.java'. Every action that takes an extension accepts it.
- `keywords` (list): The keywords the manifest lists.
- `languages` (list): The languages it teaches the editor.
- `license` (text): The licence the manifest names.
- `main_entry` (text): The script it starts from in desktop editors, or null for a theme, snippets or another extension with no code.
- `name` (text): The name the manifest gives, such as 'java'.
- `npm_dependencies` (list): The npm packages its code depends on at run time.
- `publisher` (text): The publisher the manifest names, such as 'redhat'.
- `repository_url` (text): The source repository the manifest names.
- `runs_in_browser` (true/false): True when it has code for browser editors such as vscode.dev.
- `settings` (list): The settings it adds.
- `untrusted_workspaces` (text): Whether it works in a folder the user has not trusted: 'yes', 'no' or 'limited', or null when it doesn't say.
- `version` (text): The version number, such as '1.58.0'.
- `virtual_workspaces` (text): Whether it works in a virtual workspace such as a remote repository: 'yes', 'no' or 'limited', or null when it doesn't say.
- `vscode_engine` (text): The VS Code versions it needs, in VS Code's own range syntax, such as '^1.77.0' (1.77.0 or later in 1.x).

**Example output**

```json
{
  "activation_events": [
    "workspaceContains:pom.xml",
    "workspaceContains:*/pom.xml"
  ],
  "browser_entry": null,
  "categories": [
    "Programming Languages",
    "Linters"
  ],
  "commands": [
    {
      "category": "Java",
      "command": "java.server.mode.switch",
      "title": null
    },
    {
      "category": "Java",
      "command": "java.projectConfiguration.update",
      "title": null
    }
  ],
  "contributes": [
    {
      "count": 1,
      "point": "customEditors"
    },
    {
      "count": 2,
      "point": "javaBuildFilePatterns"
    }
  ],
  "description": "Java Linting, Intellisense, formatting, refactoring, Maven/Gradle support and more...",
  "display_name": "Language Support for Java(TM) by Red Hat",
  "engines": [
    {
      "engine": "vscode",
      "range": "^1.77.0"
    }
  ],
  "extension_dependencies": [],
  "extension_kind": [],
  "extension_pack": [],
  "id": "redhat.java",
  "keywords": [
    "multi-root ready"
  ],
  "languages": [
    {
      "aliases": [],
      "file_extensions": [
        ".java",
        ".class"
      ],
      "id": "java"
    },
    {
      "aliases": [
        "Java Properties"
      ],
      "file_extensions": [
        ".properties"
      ],
      "id": "java-properties"
    }
  ],
  "license": "EPL-2.0",
  "main_entry": "./dist/extension",
  "name": "java",
  "npm_dependencies": [
    {
      "name": "@redhat-developer/vscode-extension-proposals",
      "version": "0.0.23"
    },
    {
      "name": "@redhat-developer/vscode-redhat-telemetry",
      "version": "0.10.2"
    }
  ],
  "publisher": "redhat",
  "repository_url": "https://github.com/redhat-developer/vscode-java",
  "runs_in_browser": false,
  "settings": [
    {
      "default": "null",
      "description": "Specifies the folder path to the JDK (25 or more recent) used to launch the Java Language Server.\nOn Windows, backslashes must be escaped, i.e.\n\"java.home\":\"C:\\\\Program Files\\\\Java\\\\jdk-25.0.2\"",
      "key": "java.home",
      "type": "string or null"
    },
    {
      "default": "null",
      "description": "Specifies the folder path to the JDK (25 or more recent) used to launch the Java Language Server. This setting will replace the Java extension's embedded JRE to start the Java Language Server. \n\nOn Windows, backslashes must be escaped, i.e.\n\"java.jdt.ls.java.home\":\"C:\\\\Program Files\\\\Java\\\\jdk-25.0.2\"",
      "key": "java.jdt.ls.java.home",
      "type": "string or null"
    }
  ],
  "untrusted_workspaces": "limited",
  "version": "1.58.0",
  "virtual_workspaces": "no",
  "vscode_engine": "^1.77.0"
}
```

### Get download links

Get the download link of an extension's package (.vsix) for a version and platform, with its SHA-256 checksum to check the file against, the links to Open VSX's signature and public key, and every other platform's link for the same version. Nothing is downloaded, so the extension's download count is untouched. No API key required.

**Inputs**

- Extension (`extension`, text, required): The extension's ID: its namespace and name joined by a dot, such as 'redhat.java'. 'redhat/java', a link to its open-vsx.org page or a link to its VS Code Marketplace page work too.
- Version (`version`, text): A version number such as '1.58.0'. Leave empty for the newest version, which may be a pre-release. The list offers the newest hundred; type any other version in.
- Platform (`target_platform`, text): The platform whose build to read. Most extensions have one universal build that runs anywhere, which is used when the extension has no build of its own for the platform chosen. Leave empty for the universal build, or the extension's main build when it has no universal one. One of: `universal` (Universal (runs anywhere)), `web` (Web (runs in a browser)), `win32-x64` (Windows x64), `win32-arm64` (Windows ARM64), `win32-ia32` (Windows 32-bit), `linux-x64` (Linux x64), `linux-arm64` (Linux ARM64), `linux-armhf` (Linux ARM 32-bit), `alpine-x64` (Alpine Linux x64), `alpine-arm64` (Alpine Linux ARM64), `darwin-x64` (macOS Intel), `darwin-arm64` (macOS Apple silicon).

**Outputs**

- `download_url` (text): The link to download this version's .vsix package. Downloading it counts as a download on Open VSX.
- `file_name` (text): The package's file name, such as 'redhat.java-1.58.0.vsix'.
- `id` (text): The extension's ID, its namespace and name joined by a dot, such as 'redhat.java'. Every action that takes an extension accepts it.
- `platform_downloads` (list): Every platform this version has a build for, with its download link.
- `public_key_url` (text): The link to the public key that checks the signature, or null.
- `requested_platform` (text): The platform asked for, or null for none.
- `sha256` (text): The package's SHA-256 checksum as 64 hexadecimal characters, to check a downloaded file against, or null when Open VSX has none.
- `sha256_url` (text): The link to the checksum file.
- `signature_url` (text): The link to Open VSX's signature of the package, or null.
- `target_platform` (text): The platform of the build the links are for. It is 'universal' when the platform asked for has no build of its own.
- `url` (text): This version's page on open-vsx.org.
- `version` (text): The version number, such as '1.58.0'.

**Example output**

```json
{
  "download_url": "https://open-vsx.org/api/redhat/java/linux-x64/1.58.0/file/redhat.java-1.58.0@linux-x64.vsix",
  "file_name": "redhat.java-1.58.0@linux-x64.vsix",
  "id": "redhat.java",
  "platform_downloads": [
    {
      "download_url": "https://open-vsx.org/api/redhat/java/linux-x64/1.58.0/file/redhat.java-1.58.0@linux-x64.vsix",
      "target_platform": "linux-x64"
    }
  ],
  "public_key_url": "https://open-vsx.org/api/-/public-key/14ccb407-4e79-41ed-be5a-6d608325c45a",
  "requested_platform": "linux-x64",
  "sha256": "45049a2273c78814287fb31a45255e5ce1fdbe34161bb9f1ba8f62a6aa84bdfc",
  "sha256_url": "https://open-vsx.org/api/redhat/java/linux-x64/1.58.0/file/redhat.java-1.58.0@linux-x64.sha256",
  "signature_url": "https://open-vsx.org/api/redhat/java/linux-x64/1.58.0/file/redhat.java-1.58.0@linux-x64.sigzip",
  "target_platform": "linux-x64",
  "url": "https://open-vsx.org/extension/redhat/java/linux-x64/1.58.0",
  "version": "1.58.0"
}
```

### Get README, changelog or licence

Get the text of an extension's README, changelog or licence, for its newest version or any other, up to the length you choose. A version that ships no such file comes back with 'found' set to false rather than failing the step. No API key required.

**Inputs**

- Extension (`extension`, text, required): The extension's ID: its namespace and name joined by a dot, such as 'redhat.java'. 'redhat/java', a link to its open-vsx.org page or a link to its VS Code Marketplace page work too.
- Which file (`document`, text): The README by default, or the changelog or licence. One of: `readme`, `changelog`, `license` (Licence). Default: `readme`.
- Version (`version`, text): A version number such as '1.58.0'. Leave empty for the newest version, which may be a pre-release. The list offers the newest hundred; type any other version in.
- Longest text (`max_characters`, number): How many characters to return at most, from the start of the file, up to 500,000. A changelog's newest entries come first. From 100 to 500000. Default: `20000`.

**Outputs**

- `characters` (number): How many characters of text came back.
- `document` (text): Which file: readme, changelog or license.
- `extension` (text): The extension's ID, its namespace and name joined by a dot, such as 'redhat.java'. Every action that takes an extension accepts it.
- `file_name` (text): The file's name in the package, such as 'CHANGELOG.md'.
- `found` (true/false): False when this version ships no such file; the text is then empty.
- `size_bytes` (number): The whole file's size in bytes, when Open VSX says.
- `text` (text): The file's text, usually Markdown, up to the length asked for.
- `truncated` (true/false): True when the file is longer and was cut short.
- `url` (text): The link to the file on Open VSX.
- `version` (text): The version whose file this is.

**Example output**

```json
{
  "characters": 300,
  "document": "changelog",
  "extension": "redhat.java",
  "file_name": "changelog.md",
  "found": true,
  "size_bytes": 54510,
  "text": "# Change Log\n\n## 1.58.0 (October 19, 2026)\n * bug fix - False positive \"Flexible Constructor Bodies\" errors appear when Lombok is enabled. See [#4521](https://github.com/redhat-developer/vscode-java/issues/4521), [JLS#3930](https://github.com/eclipse-jdtls/eclipse.jdt.ls/issues/3930).\n * bug fix - `",
  "truncated": true,
  "url": "https://open-vsx.org/api/redhat/java/1.58.0/file/changelog.md",
  "version": "1.58.0"
}
```

### List an extension's reviews

List the reviews people left for an extension on Open VSX, newest first, with each rating, comment and reviewer, and how many reviews gave each rating. No API key required.

**Inputs**

- Extension (`extension`, text, required): The extension's ID: its namespace and name joined by a dot, such as 'redhat.java'. 'redhat/java', a link to its open-vsx.org page or a link to its VS Code Marketplace page work too.
- Only reviews with a comment (`with_comments_only`, true/false): Leave out reviews that are a rating alone. Default: `false`.
- How many (`limit`, number): How many reviews to list, newest first, up to 500. From 1 to 500. Default: `100`.

**Outputs**

- `average_rating` (number): The average rating out of 5 across every review, or null for none.
- `count` (number): How many reviews are listed here.
- `extension` (text): The extension's ID, its namespace and name joined by a dot, such as 'redhat.java'. Every action that takes an extension accepts it.
- `more_available` (true/false): True when more reviews match than are listed.
- `review_count` (number): How many reviews it has in all.
- `reviews` (list): The reviews, newest first.
- `star_counts` (object): How many reviews gave each rating.
- `with_comment_count` (number): How many reviews have a written comment.

**Example output**

```json
{
  "average_rating": 3.88,
  "count": 2,
  "extension": "ms-python.python",
  "more_available": true,
  "review_count": 16,
  "reviews": [
    {
      "comment": "Still missing standard features from PyCharm like rich autocomplete, reference lookup, renaming on global, etc.",
      "posted_at": "2025-12-11T09:43:48.927986Z",
      "rating": 3,
      "user_avatar_url": "https://avatars.githubusercontent.com/u/22343775?v=4",
      "user_login": "Stihotvor",
      "user_name": "Yevhen D",
      "user_url": "https://github.com/Stihotvor"
    },
    {
      "comment": "Yum",
      "posted_at": "2025-10-15T23:25:24.799101Z",
      "rating": 5,
      "user_avatar_url": "https://avatars.githubusercontent.com/u/114359320?v=4",
      "user_login": "Pirate2122yt",
      "user_name": null,
      "user_url": "https://github.com/Pirate2122yt"
    }
  ],
  "star_counts": {
    "five": 11,
    "four": 0,
    "one": 4,
    "three": 1,
    "two": 0
  },
  "with_comment_count": 7
}
```

### List an extension's versions

List an extension's versions, newest version number first, with when each was published, whether it is a pre-release, the VS Code versions it needs and its download link. Narrow to stable versions or pre-releases, or to one platform's builds. No API key required.

**Inputs**

- Extension (`extension`, text, required): The extension's ID: its namespace and name joined by a dot, such as 'redhat.java'. 'redhat/java', a link to its open-vsx.org page or a link to its VS Code Marketplace page work too.
- Platform (`target_platform`, text): List this platform's builds. Leave empty for the universal build, or the extension's main build when it has no universal one. One of: `universal` (Universal (runs anywhere)), `web` (Web (runs in a browser)), `win32-x64` (Windows x64), `win32-arm64` (Windows ARM64), `win32-ia32` (Windows 32-bit), `linux-x64` (Linux x64), `linux-arm64` (Linux ARM64), `linux-armhf` (Linux ARM 32-bit), `alpine-x64` (Alpine Linux x64), `alpine-arm64` (Alpine Linux ARM64), `darwin-x64` (macOS Intel), `darwin-arm64` (macOS Apple silicon).
- Which versions (`release_type`, text): Every version by default, or stable versions or pre-releases only. One of: `all` (Every version), `stable` (Stable versions only), `pre-release` (Pre-releases only). Default: `all`.
- How many per page (`limit`, number): How many versions to return, up to 100. From 1 to 100. Default: `20`.
- Page (`page`, number): Which page of results to read: 1 for the first. At least 1. Default: `1`.

**Outputs**

- `count` (number): How many versions are on this page.
- `display_name` (text): The name people see, such as 'Language Support for Java(TM) by Red Hat'.
- `extension` (text): The extension's ID, its namespace and name joined by a dot, such as 'redhat.java'. Every action that takes an extension accepts it.
- `more_available` (true/false): True when there are more results after this page.
- `page` (number): The page of results this is, from 1.
- `release_type` (text): Which versions are listed: all, stable or pre-release.
- `target_platform` (text): The platform whose builds are listed, such as 'universal'.
- `total_versions` (number): How many versions the extension has for this platform, of every kind.
- `versions` (list): The versions, newest version number first.

**Example output**

```json
{
  "count": 2,
  "display_name": "Language Support for Java(TM) by Red Hat",
  "extension": "redhat.java",
  "more_available": true,
  "page": 1,
  "release_type": "all",
  "target_platform": "universal",
  "total_versions": 623,
  "versions": [
    {
      "changelog_url": "https://open-vsx.org/api/redhat/java/1.59.2026102108/file/changelog.md",
      "download_url": "https://open-vsx.org/api/redhat/java/1.59.2026102108/file/redhat.java-1.59.2026102108.vsix",
      "is_latest": true,
      "pre_release": true,
      "published_at": "2026-10-21T08:21:28.683632Z",
      "target_platform": "universal",
      "url": "https://open-vsx.org/extension/redhat/java/1.59.2026102108",
      "version": "1.59.2026102108",
      "vscode_engine": "^1.77.0"
    },
    {
      "changelog_url": "https://open-vsx.org/api/redhat/java/1.59.2026102008/file/changelog.md",
      "download_url": "https://open-vsx.org/api/redhat/java/1.59.2026102008/file/redhat.java-1.59.2026102008.vsix",
      "is_latest": false,
      "pre_release": true,
      "published_at": "2026-10-20T08:23:23.525818Z",
      "target_platform": "universal",
      "url": "https://open-vsx.org/extension/redhat/java/1.59.2026102008",
      "version": "1.59.2026102008",
      "vscode_engine": "^1.77.0"
    }
  ]
}
```

### List version changes

Read Open VSX's feed of version changes across the whole registry, oldest first: every version published, taken down or removed since a moment (the last 24 hours by default), optionally for one namespace or one kind of change. It hands back a cursor, so a scheduled workflow can carry on exactly where its last run stopped. Open VSX marks this feed as a preview. No API key required.

**Inputs**

- Since (`since`, date and time): Read changes from this moment on. Leave it and the cursor empty for the last 24 hours.
- Until (`until`, date and time): Read changes up to this moment. Leave empty for up to now.
- Carry on from (`cursor`, text): The next cursor an earlier step of this action returned, to read on from where it stopped. Use it instead of Since.
- Kinds of change (`change_types`, list): Only these kinds of change. Leave empty for every kind. One or more of: `available` (Published or put back), `deactivated` (Taken down for now), `removed`.
- Namespace (`namespace`, text): Only changes to this namespace's extensions, such as 'redhat'. Leave empty for the whole registry.
- How many to read (`limit`, number): How many feed entries to read at most, up to 10,000, before the filters. A busy day has a thousand or more. From 1 to 10000. Default: `1000`.

**Outputs**

- `changes` (list): The changes, oldest first: one per extension version and platform.
- `count` (number): How many of them matched the filters and are listed.
- `more_available` (true/false): True when the feed has more entries after the last one read.
- `next_cursor` (text): Where the next read should carry on from: pass it as the cursor of the next step, or keep it for the next run.
- `read_count` (number): How many feed entries were read, before filtering.
- `since` (text): Where the feed was read from, or null when a cursor was used.
- `until` (text): Where the feed was read to, or null for up to now.

**Example output**

```json
{
  "changes": [
    {
      "change": "available",
      "changed_at": "2026-10-15T08:15:19.037212Z",
      "id": "redhat.vscode-xml",
      "name": "vscode-xml",
      "namespace": "redhat",
      "published_at": "2026-10-15T08:13:09.743043Z",
      "target_platform": "darwin-arm64",
      "url": "https://open-vsx.org/extension/redhat/vscode-xml/darwin-arm64/0.29.2026101508",
      "version": "0.29.2026101508"
    },
    {
      "change": "available",
      "changed_at": "2026-10-15T08:15:33.332762Z",
      "id": "redhat.vscode-xml",
      "name": "vscode-xml",
      "namespace": "redhat",
      "published_at": "2026-10-15T08:13:23.680561Z",
      "target_platform": "universal",
      "url": "https://open-vsx.org/extension/redhat/vscode-xml/0.29.2026101508",
      "version": "0.29.2026101508"
    }
  ],
  "count": 2,
  "more_available": true,
  "next_cursor": "MjAyNi0xMC0xNVQxODo0Mzo1My44ODc3NTRfMzQ1OTYx",
  "read_count": 1000,
  "since": "2026-10-15T00:00:00Z",
  "until": null
}
```

### Look up several extensions

Look up as many as 50 extensions in one step, by ID or link, with each one's newest version, the VS Code versions it needs, downloads and whether it is deprecated. IDs Open VSX doesn't have are listed rather than failing the step, so it also tells which of a list of VS Code extensions are available on Open VSX. No API key required.

**Inputs**

- Extensions (`extensions`, list, required): The extensions' IDs (such as 'redhat.java') or links, up to 50.

**Outputs**

- `count` (number): How many of them Open VSX has.
- `extensions` (list): Each extension Open VSX has, with its newest version.
- `not_found` (list): The IDs asked for that Open VSX doesn't have.
- `requested_count` (number): How many different extensions were asked for.

**Example output**

```json
{
  "count": 2,
  "extensions": [
    {
      "average_rating": 5.0,
      "deprecated": false,
      "description": "Java Linting, Intellisense, formatting, refactoring, Maven/Gradle support and more...",
      "display_name": "Language Support for Java(TM) by Red Hat",
      "downloads": 46388093,
      "id": "redhat.java",
      "license": "EPL-2.0",
      "name": "java",
      "namespace": "redhat",
      "pre_release": true,
      "published_at": "2026-10-21T08:21:28.683632Z",
      "replacement_id": null,
      "review_count": 16,
      "url": "https://open-vsx.org/extension/redhat/java",
      "verified": true,
      "version": "1.59.2026102108",
      "vscode_engine": "^1.77.0"
    },
    {
      "average_rating": 4.35,
      "deprecated": false,
      "description": "Code formatter using prettier",
      "display_name": "Prettier - Code formatter",
      "downloads": 9604001,
      "id": "esbenp.prettier-vscode",
      "license": "MIT",
      "name": "prettier-vscode",
      "namespace": "esbenp",
      "pre_release": false,
      "published_at": "2026-03-16T19:14:43.319347Z",
      "replacement_id": null,
      "review_count": 17,
      "url": "https://open-vsx.org/extension/esbenp/prettier-vscode",
      "verified": true,
      "version": "12.4.0",
      "vscode_engine": "^1.101.0"
    }
  ],
  "not_found": [
    "ms-vscode.cpptools"
  ],
  "requested_count": 3
}
```

### Search extensions

Find VS Code extensions on Open VSX by name or words, narrowed by category or by platform, and sorted by best match, downloads, rating or last update. Each result comes with its newest version, downloads, rating and download link. No API key required.

**Inputs**

- Search text (`query`, text): Words to look for in extension names, descriptions and tags. Leave empty to browse with the filters alone.
- Category (`category`, text): Only extensions in this category, such as Themes or Linters. Leave empty for every category. One of: `AI`, `Azure`, `Chat`, `Data Science`, `Debuggers`, `Education`, `Extension Packs`, `Formatters`, `Keymaps`, `Language Packs`, and 10 more.
- Platform (`target_platform`, text): Only extensions with a build made for this platform. Most extensions ship one universal build that runs anywhere, so choose Universal to find those. Leave empty for every extension. One of: `universal` (Universal (runs anywhere)), `web` (Web (runs in a browser)), `win32-x64` (Windows x64), `win32-arm64` (Windows ARM64), `win32-ia32` (Windows 32-bit), `linux-x64` (Linux x64), `linux-arm64` (Linux ARM64), `linux-armhf` (Linux ARM 32-bit), `alpine-x64` (Alpine Linux x64), `alpine-arm64` (Alpine Linux ARM64), `darwin-x64` (macOS Intel), `darwin-arm64` (macOS Apple silicon).
- Sort by (`sort`, text): What to order the results by. Best match by default. One of: `relevance` (Best match), `downloads`, `rating`, `updated` (Last updated). Default: `relevance`.
- Order (`sort_order`, text): Highest, most or newest first by default, or the other way round. One of: `desc` (Highest, most or newest first), `asc` (Lowest, fewest or oldest first). Default: `desc`.
- How many per page (`limit`, number): How many extensions to return, up to 100. From 1 to 100. Default: `20`.
- Page (`page`, number): Which page of results to read: 1 for the first. At least 1. Default: `1`.

**Outputs**

- `category` (text): The category searched in, or null for every category.
- `count` (number): How many extensions are in this page.
- `extensions` (list): The extensions on this page.
- `more_available` (true/false): True when there are more results after this page.
- `page` (number): The page of results this is, from 1.
- `query` (text): The search text, or null when the filters alone were used.
- `sort` (text): The order of the results: relevance, downloads, rating or updated.
- `target_platform` (text): The platform searched for, or null for every platform.
- `total_matching` (number): How many extensions match in all.

**Example output**

```json
{
  "category": "Programming Languages",
  "count": 2,
  "extensions": [
    {
      "average_rating": 5.0,
      "deprecated": false,
      "description": "Java Linting, Intellisense, formatting, refactoring, Maven/Gradle support and more...",
      "display_name": "Language Support for Java(TM) by Red Hat",
      "download_url": "https://open-vsx.org/api/redhat/java/1.59.2026102108/file/redhat.java-1.59.2026102108.vsix",
      "downloads": 46388093,
      "icon_url": "https://open-vsx.org/api/redhat/java/1.59.2026102108/file/icon128.png",
      "id": "redhat.java",
      "name": "java",
      "namespace": "redhat",
      "published_at": "2026-10-21T08:21:28.683632Z",
      "review_count": 16,
      "url": "https://open-vsx.org/extension/redhat/java",
      "verified": true,
      "version": "1.59.2026102108"
    },
    {
      "average_rating": null,
      "deprecated": false,
      "description": "Manage Maven projects, execute goals, generate project from archetype, improve user experience for Java developers.",
      "display_name": "Maven for Java",
      "download_url": "https://open-vsx.org/api/vscjava/vscode-maven/0.45.3/file/vscjava.vscode-maven-0.45.3.vsix",
      "downloads": 28523197,
      "icon_url": "https://open-vsx.org/api/vscjava/vscode-maven/0.45.3/file/logo.png",
      "id": "vscjava.vscode-maven",
      "name": "vscode-maven",
      "namespace": "vscjava",
      "published_at": "2026-04-27T04:37:34.044171Z",
      "review_count": 0,
      "url": "https://open-vsx.org/extension/vscjava/vscode-maven",
      "verified": true,
      "version": "0.45.3"
    }
  ],
  "more_available": true,
  "page": 1,
  "query": "java",
  "sort": "downloads",
  "target_platform": null,
  "total_matching": 227
}
```
