Get Version

npm.get_version
ActionBusiness appsconnection required

Calls the npm Registry API with the connection's credentials.

Read one version's manifest, by version number or by dist-tag.

Connection

Required
Yes — the node will not save without one
Auth type
Bearer token
Providers
npm Registry
Secret shape
optional — the npm token, or {"api_token": "…"}; reads need none
Config it needs
base_url
Resolved by
config.connection_id, else node.connection_id

Configuration

2 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
package
The package name, scope included — the slash in a scoped name is escaped for you.
stringYes——express
version
The version to read, as a version number or a dist-tag name.
stringNolatest—latest

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "package": "express",
  "version": "latest"
}

Output

One shape.

result

FieldTypeExample
name
The package name.
string—
version
This manifest's version.
string—
description
The package description.
string—
license
The package's licence identifier.
string—
main
The package's entry point.
string—
dependencies
Runtime dependencies, as name to range.
object—
devDependencies
Development dependencies, as name to range.
object—
peerDependencies
Peer dependencies, as name to range.
object—
engines
The runtimes this version declares support for.
object—
dist.tarball
URL of the published tarball.
string—
dist.shasum
SHA-1 of the tarball.
string—
dist.integrity
Subresource-integrity hash of the tarball.
string—
dist.fileCount
How many files the tarball holds.
number—
dist.unpackedSize
Unpacked size of the tarball, in bytes.
number—
repository
Where the source lives.
object—
deprecated
The deprecation message, when this version is deprecated.
string—
{
  "dependencies": {},
  "deprecated": "",
  "description": "",
  "devDependencies": {},
  "dist": {
    "fileCount": 0,
    "integrity": "",
    "shasum": "",
    "tarball": "",
    "unpackedSize": 0
  },
  "engines": {},
  "license": "",
  "main": "",
  "name": "",
  "peerDependencies": {},
  "repository": {},
  "version": ""
}

See Get Version run in a workflow.

In a technical demo we add the npm Registry connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.