Access Control Entries - Remove Access Control Entries

Remove the specified ACEs from the ACL belonging to the specified token.

DELETE https://dev.azure.com/{organization}/_apis/accesscontrolentries/{securityNamespaceId}?api-version=6.0
DELETE https://dev.azure.com/{organization}/_apis/accesscontrolentries/{securityNamespaceId}?token={token}&descriptors={descriptors}&api-version=6.0

URI Parameters

Name In Required Type Description
securityNamespaceId
path True
  • string
uuid

Security namespace identifier.

organization
path
  • string

The name of the Azure DevOps organization.

api-version
query True
  • string

Version of the API to use. This should be set to '6.0' to use this version of the api.

descriptors
query
  • string

String containing a list of identity descriptors separated by ',' whose entries should be removed.

token
query
  • string

The token whose ACL should be modified.

Responses

Name Type Description
200 OK
  • boolean

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.security_manage Grants the ability to read, write, and manage security permissions.

Examples

Sample Request

DELETE https://dev.azure.com/fabrikam/_apis/accesscontrolentries/5a27515b-ccd7-42c9-84f1-54c998f03866?token=newToken&descriptors=Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1,Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-2&api-version=6.0

Sample Response

true