Websites - Revoke Exception

Service:

Power Platform API

API Version:

2024-10-01

Revokes an admin exception for one or more Power Pages websites in a tenant.
Revokes a previously granted admin exception across one or more websites in the tenant. Each exception state row is force-expired and asynchronous application-setting revert is queued.

POST https://api.powerplatform.com/powerpages/environments/{environmentId}/exceptions/revoke?api-version=2024-10-01

URI Parameters

Name	In	Required	Type	Description
environmentId	path	True	string	The environment ID.
api-version	query	True	string	The API version.

Request Body

Name	Type	Description
exceptionType	ExceptionType	Exception scenario discriminator identifying which admin exception ("break-glass") scenario a grant, revoke, or query targets.
portalIds	string[]	Websites whose exception should be revoked (deduplicated server-side).

Responses

Name	Type	Description
200 OK	RevokeExceptionResult	OK
400 Bad Request	ErrorMessage	Bad Request
401 Unauthorized	ErrorMessage	Unauthorized
404 Not Found	ErrorMessage	Not Found

Security

oauth2

Microsoft Entra ID OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=https://api.powerplatform.com

Scopes

Name	Description
.default	.default

Definitions

Name	Description
Details
Error
ErrorMessage
ExceptionType	Exception scenario discriminator identifying which admin exception ("break-glass") scenario a grant, revoke, or query targets.
PortalExceptionResult
RevokeExceptionRequest
RevokeExceptionResult

Details

Object

Name	Type	Description
code	string	Error code
message	string	Error message
target	string	Target parameter

Error

Object

Name	Type	Description
code	string	Error code
details	Details[]
message	string	Error message
target	string	Target parameter

ErrorMessage

Object

Name	Type	Description
error	Error

ExceptionType

Enumeration

Exception scenario discriminator identifying which admin exception ("break-glass") scenario a grant, revoke, or query targets.

Value	Description
WebApiStarRetirement

PortalExceptionResult

Object

Name	Type	Description
message	string	Optional human-readable detail (populated for non-granted outcomes).
portalId	string	Website unique identifier (ID).
status	string	Per-website outcome status, e.g. "Granted", "Accepted", "AlreadyGranted", "NotApplicable", "Failed", "Revoked", "AlreadyRevoked".

RevokeExceptionRequest

Object

Name	Type	Description
exceptionType	ExceptionType	Exception scenario discriminator identifying which admin exception ("break-glass") scenario a grant, revoke, or query targets.
portalIds	string[]	Websites whose exception should be revoked (deduplicated server-side).

RevokeExceptionResult

Object

Name	Type	Description
auditId	string	Id of the audit record created for this revoke request.
exceptionType	ExceptionType	Exception scenario discriminator identifying which admin exception ("break-glass") scenario a grant, revoke, or query targets.
portals	PortalExceptionResult[]	Per-website outcomes.
propagationOrchestrationId	string	Optional orchestration instance id for the queued application-setting revert propagation.