Feeds

Last Update: 12/5/2016

api-version = 2.0-preview.1

This API in preview. Learn more

If you haven't already, look at the information on getting started with these APIs.

Get feeds

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

Sample request

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

Sample response

Status code: 200
{
  "count": 1,
  "value": [
    {
      "id": "64ccc8b7-705d-48f7-a91c-d9be3cd36468",
      "name": "EngineeringInternal",
      "description": "Contains packages internal to the engineering organization",
      "url": "http://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468",
      "_links": {
        "self": {
          "href": "http://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468"
        }
      }
    }
  ]
}

Get a feed

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

Sample request

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

Sample response

Status code: 200
{
  "id": "64ccc8b7-705d-48f7-a91c-d9be3cd36468",
  "name": "EngineeringInternal",
  "description": "Contains packages internal to the engineering organization",
  "url": "http://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468",
  "_links": {
    "self": {
      "href": "http://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468"
    }
  }
}

Create a feed

POST https://{account}.Feeds.VisualStudio.com/DefaultCollection/_apis/packaging/feeds?api-version={version}
Content-Type: application/json
{
    "name" : "EngineeringInternal",
    "description" : "Contains packages internal to the engineering organization"  
}
Parameter Type Notes
URL
account string Visual Studio Team Services account.
Query
api-version string Version of the API to use.
Body
name string Name of the feed to be created. Optional.
description string Description of the feed to be created. Optional.

Sample request

POST http://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/packaging/feeds?api-version=2.0-preview.1
Content-Type: application/json
{
  "name": "EngineeringInternal",
  "description": "Contains packages internal to the engineering organization"
}

Sample response

Status code: 201
{
  "id": "64ccc8b7-705d-48f7-a91c-d9be3cd36468",
  "name": "EngineeringInternal",
  "description": "Contains packages internal to the engineering organization",
  "url": "http://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468",
  "_links": {
    "self": {
      "href": "http://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468"
    }
  }
}

Update a feed

PATCH https://{account}.Feeds.VisualStudio.com/DefaultCollection/_apis/packaging/feeds/{feed}?api-version={version}
Content-Type: application/json
{
    "name" : "LegacyEngineeringInternal",
    "description" : "Contains legacy packages internal to the engineering organization"  
}
Parameter Type Notes
URL
account string Visual Studio Team Services account.
feed string Name or ID of feed to be updated
Query
api-version string Version of the API to use.
Body
name string Updated name of the feed.
description string Updated description of the feed.

Sample request

PATCH http://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/packaging/feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468?api-version=2.0-preview.1
Content-Type: application/json
{
  "name": "LegacyEngineeringInternal",
  "description": "Contains legacy packages internal to the engineering organization"
}

Sample response

Status code: 200
{
  "id": "64ccc8b7-705d-48f7-a91c-d9be3cd36468",
  "name": "LegacyEngineeringInternal",
  "description": "Contains legacy packages internal to the engineering organization",
  "url": "http://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468",
  "_links": {
    "self": {
      "href": "http://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468"
    }
  }
}

Delete a feed

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

Sample request

DELETE http://fabrikam.feeds.visualstudio.com/DefaultCollection/_apis/packaging/feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468?api-version=2.0-preview.1

Sample response

Status code: 204