Release views

Last Update: 12/8/2016

api-version = 3.0-preview

This API in preview. Learn more

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

Get release views

GET https://{account}.Feeds.VisualStudio.com/DefaultCollection/_apis/packaging/feeds/{feed}/views?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 https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/packaging/feeds/fabrikam/views?api-version=3.0-preview

Sample response

Status code: 200
{
  "count": 2,
  "value": [
    {
      "id": "3d80c2b2-aa5a-4e10-bca9-4775c6e37b04",
      "name": "Prerelease",
      "url": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40/Views/3d80c2b2-aa5a-4e10-bca9-4775c6e37b04",
      "type": "release",
      "_links": {
        "self": {
          "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40/Views/3d80c2b2-aa5a-4e10-bca9-4775c6e37b04"
        },
        "feed": {
          "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40"
        },
        "packages": {
          "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40@3d80c2b2-aa5a-4e10-bca9-4775c6e37b04/Packages"
        }
      }
    },
    {
      "id": "e7d6aa9e-27e6-4e42-b65e-9cb4781628a9",
      "name": "Release",
      "url": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40/Views/e7d6aa9e-27e6-4e42-b65e-9cb4781628a9",
      "type": "release",
      "_links": {
        "self": {
          "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40/Views/e7d6aa9e-27e6-4e42-b65e-9cb4781628a9"
        },
        "feed": {
          "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40"
        },
        "packages": {
          "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40@e7d6aa9e-27e6-4e42-b65e-9cb4781628a9/Packages"
        }
      }
    }
  ]
}

Get a release view

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

Sample request

GET https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/packaging/feeds/fabrikam/views/Alpha?api-version=3.0-preview

Sample response

Status code: 200
{
  "id": "b0024744-d616-41f3-af01-34eb4d33efe5",
  "name": "Alpha",
  "url": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40/Views/b0024744-d616-41f3-af01-34eb4d33efe5",
  "type": "release",
  "_links": {
    "self": {
      "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40/Views/b0024744-d616-41f3-af01-34eb4d33efe5"
    },
    "feed": {
      "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40"
    },
    "packages": {
      "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40@b0024744-d616-41f3-af01-34eb4d33efe5/Packages"
    }
  }
}

Create a release view

Release view names are limited to 64 characters and can only contain alphanumeric characters.

POST https://{account}.Feeds.VisualStudio.com/DefaultCollection/_apis/packaging/feeds/{feed}/views?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.
Body
name string Name of the release view to be created.
type string Type of the release view to be created, currently only "release" views are supported.

Sample request

POST https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/packaging/feeds/fabrikam/views?api-version=3.0-preview
Content-Type: application/json
{
  "name": "Alpha",
  "type": "release"
}

Sample response

Status code: 201
{
  "id": "b0024744-d616-41f3-af01-34eb4d33efe5",
  "name": "Alpha",
  "url": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40/Views/b0024744-d616-41f3-af01-34eb4d33efe5",
  "type": "release",
  "_links": {
    "self": {
      "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40/Views/b0024744-d616-41f3-af01-34eb4d33efe5"
    },
    "feed": {
      "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40"
    },
    "packages": {
      "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40@b0024744-d616-41f3-af01-34eb4d33efe5/Packages"
    }
  }
}

Update a release view

PATCH https://{account}.Feeds.VisualStudio.com/DefaultCollection/_apis/packaging/feeds/{feed}/views/{view}?api-version={version}
Parameter Type Notes
URL
account string Visual Studio Team Services account.
feed string Name or ID of feed to be updated.
view string Name or ID of the release view to be updated.
Query
api-version string Version of the API to use.
Body
name string Updated name of the release view.

Sample request

PATCH https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/packaging/feeds/fabrikam/views/Alpha?api-version=3.0-preview
Content-Type: application/json
{
  "name": "Beta"
}

Sample response

Status code: 200
{
  "id": "b0024744-d616-41f3-af01-34eb4d33efe5",
  "name": "Beta",
  "url": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40/Views/b0024744-d616-41f3-af01-34eb4d33efe5",
  "type": "release",
  "_links": {
    "self": {
      "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40/Views/b0024744-d616-41f3-af01-34eb4d33efe5"
    },
    "feed": {
      "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40"
    },
    "packages": {
      "href": "https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/Packaging/Feeds/8c2a4e66-9205-4a9b-8bd1-16799a65fb40@b0024744-d616-41f3-af01-34eb4d33efe5/Packages"
    }
  }
}

Delete a release view

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

Sample request

DELETE https://contoso.feeds.visualstudio.com/DefaultCollection/_apis/packaging/feeds/fabrikam/views/Beta?api-version=3.0-preview

Sample response

Status code: 204