Feed Management - Get Feed Permissions

Service:: Artifacts

API Version:: 7.1

Get the permissions for a feed.

The project parameter must be supplied if the feed was created in a project. If the feed is not associated with any project, omit the project parameter from the request.

GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/Feeds/{feedId}/permissions?api-version=7.1

With optional parameters:

GET https://feeds.dev.azure.com/{organization}/{project}/_apis/packaging/Feeds/{feedId}/permissions?includeIds={includeIds}&excludeInheritedPermissions={excludeInheritedPermissions}&identityDescriptor={identityDescriptor}&includeDeletedFeeds={includeDeletedFeeds}&api-version=7.1

URI Parameters

Name	In	Required	Type	Description
feedId	path	True	string	Name or Id of the feed.
organization	path	True	string	The name of the Azure DevOps organization.
project	path		string	Project ID or project name
api-version	query	True	string	Version of the API to use. This should be set to '7.1' to use this version of the api.
excludeInheritedPermissions	query		boolean	True to only return explicitly set permissions on the feed. Default is false.
identityDescriptor	query		string	Filter permissions to the provided identity.
includeDeletedFeeds	query		boolean	If includeDeletedFeeds is true, then feedId must be specified by name and not by Guid.
includeIds	query		boolean	True to include user Ids in the response. Default is false.

Responses

Name	Type	Description
200 OK	FeedPermission[]	successful operation

Security

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Name	Description
vso.packaging	Grants the ability to read feeds and packages. Also grants the ability to search packages.

Definitions

Name	Description
FeedPermission	Permissions for a feed.
FeedRole	The role for this identity on a feed.
IdentityDescriptor	An Identity descriptor is a wrapper for the identity type (Windows SID, Passport) along with a unique identifier such as the SID or PUID.

FeedPermission

Object

Permissions for a feed.

Name	Type	Description
displayName	string	Display name for the identity.
identityDescriptor	IdentityDescriptor	Identity associated with this role.
identityId	string (uuid)	Id of the identity associated with this role.
isInheritedRole	boolean	Boolean indicating whether the role is inherited or set directly.
role	FeedRole	The role for this identity on a feed.

FeedRole

Enumeration

The role for this identity on a feed.

Value	Description
administrator	Administrators have total control over the feed.
collaborator	Collaborators have the same permissions as readers, but can also ingest packages from configured upstream sources.
contributor	Contributors can do anything to packages in the feed including adding new packages, but they may not modify feed settings.
custom	Unsupported.
none	Unsupported.
reader	Readers can only read packages and view settings.

IdentityDescriptor