Service Principals - Delete

  • Reference
Service:
Graph
API Version:
7.1-preview.1

Disables a service principal.

The service principal will still be visible, but membership checks for the service principal will return false.

DELETE https://vssps.dev.azure.com/{organization}/_apis/graph/serviceprincipals/{servicePrincipalDescriptor}?api-version=7.1-preview.1

URI Parameters

Name In Required Type Description
organization
 path True

string

The name of the Azure DevOps organization.
servicePrincipalDescriptor
 path True

string

The descriptor of the service principal to delete.
api-version
 query True

string

Version of the API to use. This should be set to '7.1-preview.1' to use this version of the api.

Responses

Name Type Description
200 OK

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.graph_manage Grants the ability to read user, group, scope and group membership information, and to add users, groups and manage group memberships

Examples

Sample Request

DELETE https://vssps.dev.azure.com/{organization}/_apis/graph/serviceprincipals/aadsp.NTkzZjY3MTYtNjI3Yy03Y2NiLTgzM2UtNzdhN2Y5Y2E0MjJm?api-version=7.1-preview.1

Sample Response

Status code:
204