Feed Polling

Last Update: 12/5/2016

api-version = 2.0-preview.1

This API in preview. Learn more

These APIs can help you stay up-to-date with the contents of a feed or feeds.

Poll all feeds for updates

GET https://{account}.Feeds.VisualStudio.com/DefaultCollection/_apis/packaging/feedChanges?api-version={version}
Parameter Type Notes
URL
account string Visual Studio Team Services account.
Query
includeDeleted boolean If true, get changes for all feeds including deleted feeds. The default value is false.
continuationToken long A continuation token which acts as a bookmark to a previously retrieved change. This token allows the user to continue retrieving changes in batches, picking up where the previous batch left off. If specified, all the changes that occur strictly after the token will be returned. If not specified or 0, iteration will start with the first change.
batchSize int Number of feed changes to fetch. The default value is 1000. The maximum value is 2000.
api-version string Version of the API to use.

Sample request

GET http://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/packaging/feedChanges?api-version=2.0-preview.1

Sample response

Status code: 200
{
  "count": 2,
  "feedchanges": [
    {
      "feed": {
        "id": "64ccc8b7-705d-48f7-a91c-d9be3cd36468",
        "name": "EngineeringInternal",
        "description": "Contains packages internal to the engineering organization",
        "upstreamEnabled": false,
        "url": "https://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468"
      },
      "changeType": "addOrUpdate",
      "feedContinuationToken": 1,
      "latestPackageContinuationToken": 2000
    },
    {
      "feed": {
        "id": "1ff10ae7-62f5-487c-8040-feeee696cddb",
        "name": "EngineeringExternal",
        "description": "Contains packages external to the engineering organization",
        "upstreamEnabled": false,
        "url": "https://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/1ff10ae7-62f5-487c-8040-feeee696cddb"
      },
      "changeType": "addOrUpdate",
      "feedContinuationToken": 2,
      "latestPackageContinuationToken": 3000
    }
  ],
  "nextFeedContinuationToken": 2,
  "_links": {
    "next": {
      "href": "https://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/FeedChanges?continuationtoken=2&batchSize=1000"
    }
  }
}

Poll a feed for metadata updates

GET https://{account}.Feeds.VisualStudio.com/DefaultCollection/_apis/packaging/feedChanges/{feed}?api-version={version}
Parameter Type Notes
URL
account string Visual Studio Team Services account.
feed string Name or ID of feed.
Query
api-version string Version of the API to use.

Sample request

GET http://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/packaging/feedChanges/EngineeringInternal?api-version=2.0-preview.1

Sample response

Status code: 200
{
  "feed": {
    "id": "64ccc8b7-705d-48f7-a91c-d9be3cd36468",
    "name": "EngineeringInternal",
    "description": "Contains packages internal to the engineering organization",
    "upstreamEnabled": "false",
    "url": "https://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468"
  },
  "changeType": "addOrUpdate",
  "feedContinuationToken": 1,
  "latestPackageContinuationToken": 2000
}

Poll a feed for package updates

GET https://{account}.Feeds.VisualStudio.com/DefaultCollection/_apis/packaging/feeds/{feed}/packageChanges?api-version={version}
Parameter Type Notes
URL
account string Visual Studio Team Services account.
feed string Name or ID of feed.
Query
continuationToken long A continuation token which acts as a bookmark to a previously retrieved change. This token allows the user to continue retrieving changes in batches, picking up where the previous batch left off. If specified, all the changes that occur strictly after the token will be returned. If not specified or 0, iteration will start with the first change.
batchSize int Number of package changes to fetch. The default value is 1000. The maximum value is 2000.
api-version string Version of the API to use.

Sample request

GET http://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/packaging/feeds/EngineeringInternal/packageChanges?api-version=2.0-preview.1

Sample response

Status code: 200
{
  "count": 2,
  "packageChanges": [
    {
      "package": {
        "id": "1c3db219-57b8-4ff6-9966-04cf20d0c3c2",
        "normalizedName": "testpackage",
        "name": "TestPackage",
        "protocolType": "NuGet"
      },
      "packageVersionChange": {
        "packageVersion": {
          "id": "70427b86-1c84-436c-ad3b-b49c9b92c65b",
          "normalizedVersion": "1.0.0",
          "version": "1.0.0",
          "summary": "this is for testing",
          "description": "this is test package v1.0.0",
          "author": "testauthor",
          "publishDate": "2015-11-07T01:10:50.8157964Z",
          "isListed": true
        },
        "changeType": "addOrUpdate",
        "continuationToken": 1
      }
    },
    {
      "package": {
        "id": "1c3db219-57b8-4ff6-9966-04cf20d0c3c2",
        "normalizedName": "testpackage",
        "name": "TestPackage",
        "protocolType": "NuGet"
      },
      "packageVersionChange": {
        "packageVersion": {
          "id": "9f2d11b4-4b1b-4f2f-8c02-88205630007a",
          "normalizedVersion": "1.0.1",
          "version": "1.0.1",
          "summary": "this is for testing",
          "description": "this is test package v1.0.1",
          "author": "testauthor",
          "publishDate": "2015-11-07T01:12:18.1266668Z",
          "isListed": true
        },
        "changeType": "addOrUpdate",
        "continuationToken": 2
      }
    }
  ],
  "nextPackageContinuationToken": 2,
  "_links": {
    "next": {
      "href": "https://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468/PackageChanges?continuationtoken=2&batchSize=1000"
    }
  }
}