Get Dist-Tags

npm.get_dist_tags
ActionBusiness appsconnection required

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

Read every dist-tag on a package and the version each points at.

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

1 field, 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

Example configuration

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

{
  "package": "express"
}

Output

One shape.

result

FieldTypeExample
dist_tags
Every dist-tag and the version it points at.
object—
tags
The dist-tag names, sorted.
array—
latest
The version the 'latest' dist-tag points at.
string—
{
  "dist_tags": {},
  "latest": "",
  "tags": []
}

See Get Dist-Tags 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.