Share via

Access Control Entries - Remove Access Control Entries

  • Reference
Service:
Security
API Version:
7.1

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

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

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 '7.1' 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=7.1

Sample response

Status code:
200 
true