Feeds

TFS 2017 | TFS 2015 | TFS 2013

Note

Looking for REST APIS that support TFS 2018 or later versions? See the Azure DevOps REST API Reference.

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	VSTS organization.
Query
api-version	string	Version of the API to use.

Sample request

GET https://mytfsserver/DefaultCollection/_apis/packaging/feeds?api-version=2.0-preview.1

Sample response

{
  "count": 1,
  "value": [
    {
      "id": "64ccc8b7-705d-48f7-a91c-d9be3cd36468",
      "name": "EngineeringInternal",
      "description": "Contains packages internal to the engineering organization",
      "url": "https://mytfsserver/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468",
      "_links": {
        "self": {
          "href": "https://mytfsserver/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	VSTS organization.
feed	string	Name or ID of the feed.
Query
api-version	string	Version of the API to use.

Sample request

GET https://mytfsserver/DefaultCollection/_apis/packaging/feeds/EngineeringInternal?api-version=2.0-preview.1

Sample response

{
  "id": "64ccc8b7-705d-48f7-a91c-d9be3cd36468",
  "name": "EngineeringInternal",
  "description": "Contains packages internal to the engineering organization",
  "url": "https://mytfsserver/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468",
  "_links": {
    "self": {
      "href": "https://mytfsserver/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	VSTS organization.
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 https://mytfsserver/DefaultCollection/_apis/packaging/feeds?api-version=2.0-preview.1

{
  "name": "EngineeringInternal",
  "description": "Contains packages internal to the engineering organization"
}

Sample response

{
  "id": "64ccc8b7-705d-48f7-a91c-d9be3cd36468",
  "name": "EngineeringInternal",
  "description": "Contains packages internal to the engineering organization",
  "url": "https://mytfsserver/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468",
  "_links": {
    "self": {
      "href": "https://mytfsserver/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	VSTS organization.
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 https://mytfsserver/DefaultCollection/_apis/packaging/feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468?api-version=2.0-preview.1

{
  "name": "LegacyEngineeringInternal",
  "description": "Contains legacy packages internal to the engineering organization"
}

Sample response

{
  "id": "64ccc8b7-705d-48f7-a91c-d9be3cd36468",
  "name": "LegacyEngineeringInternal",
  "description": "Contains legacy packages internal to the engineering organization",
  "url": "https://mytfsserver/DefaultCollection/_apis/Packaging/Feeds/64ccc8b7-705d-48f7-a91c-d9be3cd36468",
  "_links": {
    "self": {
      "href": "https://mytfsserver/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	VSTS organization.
feed	string	Name or ID of the feed to be deleted.
Query
api-version	string	Version of the API to use.

Sample request

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