Access Control Lists - Remove Access Control Lists

  • Reference
Service:
Security
API Version:
5.1

Remove access control lists under the specfied security namespace.

DELETE https://dev.azure.com/{organization}/_apis/accesscontrollists/{securityNamespaceId}?api-version=5.1
With optional parameters: 
DELETE https://dev.azure.com/{organization}/_apis/accesscontrollists/{securityNamespaceId}?tokens={tokens}&recurse={recurse}&api-version=5.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 '5.1' to use this version of the api.
recurse
 query

boolean

If true and this is a hierarchical namespace, also remove child ACLs of the specified tokens.
tokens
 query

string

One or more comma-separated security tokens

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/accesscontrollists/5a27515b-ccd7-42c9-84f1-54c998f03866?tokens=token1,token2&recurse=False&api-version=5.1

Sample Response

Status code:
200 
true