Delete Dist-Tag

npm.delete_dist_tag
ActionBusiness appsconnection required

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

Remove a dist-tag from a package, leaving its versions in place.

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, 2 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
tag
The dist-tag to act on, such as latest, next or beta.
stringYes——next

Example configuration

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

{
  "package": "express",
  "tag": "next"
}

Output

One shape.

result

FieldTypeExample
package
The package the tag was removed from.
string—
tag
The dist-tag that was removed.
string—
deleted
True when the registry accepted the removal.
boolean—
{
  "deleted": false,
  "package": "",
  "tag": ""
}

Notes

  • This is a publish: the connection needs a token with write access to the package. The 'latest' tag cannot be removed.

See Delete Dist-Tag 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.