npm

Last Update: 3/28/2017

api-version = 3.0-preview.1

This API in preview. Learn more

Get package info

Parameter Type Default Notes
URL
account string Visual Studio Team Services account.
feedName string Name or ID of the feed.
packageScope string Scope of the package, preceded by an @-symbol. Required parameter for scoped packages.
packageName string Name or ID of the package.
packageVersion string Version of the package or Version ID. Dist-tags are not currently supported.
showUnpublished bool false Set to true to return metadata for packages that have been unpublished.
api-version string Version of the API to use.

Unscoped packages

GET https://{account}.pkgs.visualstudio.com/defaultcollection/_apis/packaging/feeds/{feedName}/npm/{packageName}/versions/{packageVersion}?api-version={api-version}&showUnpublished={showUnpublished}

Sample request

GET https://fabrikam.pkgs.visualstudio.com/DefaultCollection/_apis/packaging/feeds/contoso/npm/bootstrap/versions/3.3.6/?api-version=3.0-preview

Sample response

Status code: 202
{
  "id": "bootstrap",
  "name": "bootstrap",
  "version": "3.3.6",
  "unpublishedDate": null,
  "deprecateMessage": null
}

Scoped packages

GET https://{account}.pkgs.visualstudio.com/defaultcollection/_apis/packaging/feeds/{feedName}/npm/@{packageScope}/{packageName}/versions/{packageVersion}?api-version={api-version}&showUnpublished={showUnpublished}

Sample request

GET https://fabrikam.pkgs.visualstudio.com/DefaultCollection/_apis/packaging/feeds/contoso/npm/@myscope/bootstrap/versions/3.3.6/?api-version=3.0-preview

Sample response

Status code: 202
{
  "id": "@myscope/bootstrap",
  "name": "@myscope/bootstrap",
  "version": "3.3.6",
  "unpublishedDate": null,
  "deprecateMessage": null
}

Deprecate a package

Parameter Type Default Notes
URL
account string Visual Studio Team Services account.
feedName string Name or ID of the feed.
packageScope string Scope of the package, preceded by an @-symbol. Required parameter for scoped packages.
packageName string Name or ID of the package.
packageVersion string Version of the package or Version ID.
api-version string Version of the API to use.

Unscoped packages

PATCH https://{account}.pkgs.visualstudio.com/defaultcollection/_apis/packaging/feeds/{feedname}/npm/{packageName}/versions/{packageVersion}/content?api-version={api-version}

Sample request

PATCH https://fabrikam.pkgs.visualstudio.com/DefaultCollection/_apis/packaging/feeds/contoso/npm/bootstrap/versions/3.3.6/?api-version=3.0-preview
Content-Type: application/json
{
  "deprecateMessage": "This package has been deprecated. Please use version 3.3.7 instead."
}

Sample response

Status code: 202
{
  "id": "bootstrap",
  "name": "bootstrap",
  "version": "3.3.6",
  "unpublishedDate": null,
  "deprecateMessage": "This package has been deprecated. Please use version 3.3.7 instead."
}

Scoped packages

PATCH https://{account}.pkgs.visualstudio.com/defaultcollection/_apis/packaging/feeds/{feedname}/npm/@{packageScope}/{packageName}/versions/{packageVersion}/content?api-version={api-version}

Sample request

PATCH https://fabrikam.pkgs.visualstudio.com/DefaultCollection/_apis/packaging/feeds/contoso/npm/@myscope/bootstrap/versions/3.3.6/?api-version=3.0-preview
Content-Type: application/json
{
  "deprecateMessage": "This package has been deprecated. Please use version 3.3.7 instead."
}

Sample response

Status code: 202
{
  "id": "@myscope/bootstrap",
  "name": "@myscope/bootstrap",
  "version": "3.3.6",
  "unpublishedDate": null,
  "deprecateMessage": "This package has been deprecated. Please use version 3.3.7 instead."
}

Undeprecate a package

To undeprecate a package, call the deprecate package API with an empty deprecation message.

Unpublish

Parameter Type Default Notes
URL
account string Visual Studio Team Services account.
feedName string Name or ID of the feed.
packageScope string Scope of the package, preceded by an @-symbol. Required parameter for scoped packages.
packageName string Name or ID of the package.
packageVersion string Version of the package or Version ID.
api-version string Version of the API to use.

Unscoped packages

DELETE https://{account}.pkgs.visualstudio.com/defaultcollection/_apis/packaging/feeds/{feedName}/npm/{packageName}/versions/{packageVersion}?api-version={api-version}

Sample request

DELETE https://fabrikam.pkgs.visualstudio.com/DefaultCollection/_apis/packaging/feeds/contoso/npm/bootstrap/versions/3.3.6/?api-version=3.0-preview

Sample response

Status code: 202
{
  "id": "bootstrap",
  "name": "bootstrap",
  "version": "3.3.6",
  "unpublishedDate": "2016-11-29T20:59:18.9752022Z",
  "deprecateMessage": null
}

Scoped packages

DELETE https://{account}.pkgs.visualstudio.com/defaultcollection/_apis/packaging/feeds/{feedName}/npm/@{packageScope}/{packageName}/versions/{packageVersion}?api-version={api-version}

Sample request

DELETE https://fabrikam.pkgs.visualstudio.com/DefaultCollection/_apis/packaging/feeds/contoso/npm/@myscope/bootstrap/versions/3.3.6/?api-version=3.0-preview

Sample response

Status code: 202
{
  "id": "@myscope/bootstrap",
  "name": "@myscope/bootstrap",
  "version": "3.3.6",
  "unpublishedDate": "2016-11-29T20:59:19.6158258Z",
  "deprecateMessage": null
}

Download Package

This endpoint is not intended for programmatic usage or bulk downloads. The service will throttle when excessive use is detected.

Parameter Type Default Notes
URL
account string Visual Studio Team Services account.
feedName string Name or Id of the feed
packageScope string Scope of the package, preceded by an @-symbol. Required parameter for scoped packages.
packageName string Normalized Name or ID of the package
packageVersion string Version of the package or Version ID
api-version string Version of the API to use.

Unscoped packages

GET https://{account}.pkgs.visualstudio.com/defaultcollection/_apis/packaging/feeds/{feedname}/npm/packages/{packagename}/versions/{packageversion}/content?api-version={api-version}

Sample request

GET https://fabrikam.pkgs.visualstudio.com/DefaultCollection/_apis/packaging/feeds/contoso/npm/packages/bootstrap/versions/3.3.6/content?api-version=2.0-preview

Sample response

Status code: 200
"ResponseIsBinary"

Scoped packages

GET https://{account}.pkgs.visualstudio.com/defaultcollection/_apis/packaging/feeds/{feedname}/npm/@{packageScope}/packages/{packagename}/versions/{packageversion}/content?api-version={api-version}

Sample request

GET https://fabrikam.pkgs.visualstudio.com/DefaultCollection/_apis/packaging/feeds/contoso/npm/packages/@myscope/bootstrap/versions/3.3.6/content?api-version=2.0-preview

Sample response

Status code: 200
"ResponseIsBinary"

Release a package

Parameter Type Default Notes
URL
account string Visual Studio Team Services account.
feedName string Name or ID of the feed.
packageScope string Scope of the package, preceded by an @-symbol. Required parameter for scoped packages.
packageName string Name or ID of the package.
packageVersion string Version of the package or Version ID.
api-version string Version of the API to use.
Body
views string JSON patch object

Unscoped packages

PATCH https://{account}.pkgs.VisualStudio.com/DefaultCollection/_apis/packaging/feeds/{feedName}/npm/{packageName}/versions/{packageVersion}?api-version={api-version}

Sample request

PATCH https://fabrikam.pkgs.visualstudio.com/DefaultCollection/_apis/packaging/feeds/contoso/npm/bootstrap/versions/3.3.6/?api-version=3.0-preview
Content-Type: application/json
{
  "views": {
    "op": "add",
    "path": "/views/-",
    "value": "release"
  }
}

Sample response

Status code: 202
{
  "id": "bootstrap",
  "name": "bootstrap",
  "version": "3.3.6",
  "unpublishedDate": null,
  "deprecateMessage": null
}

Scoped packages

PATCH https://{account}.pkgs.VisualStudio.com/DefaultCollection/_apis/packaging/feeds/{feedName}/npm/@{packageScope}/{packageName}/versions/{packageVersion}?api-version={api-version}

Sample request

PATCH https://fabrikam.pkgs.visualstudio.com/DefaultCollection/_apis/packaging/feeds/contoso/npm/@myscope/bootstrap/versions/3.3.6/?api-version=3.0-preview
Content-Type: application/json
{
  "views": {
    "op": "add",
    "path": "/views/-",
    "value": "release"
  }
}

Sample response

Status code: 202
{
  "id": "@myscope/bootstrap",
  "name": "@myscope/bootstrap",
  "version": "3.3.6",
  "unpublishedDate": null,
  "deprecateMessage": null
}