/api/v1/fabric-connections/{sourceUuid}/removal-plans/{planUuid}/confirmations
Confirms that the Viewer assignments selected in the reviewed removal plan are absent. A partial confirmation keeps the source and plan available. The source is removed only when every required permission removal is confirmed and the source remains eligible for removal. Requires the GV.APIOwner application role, or a higher role (Owner > Contributor > Reader).
Operation ID · confirm_fabric_connection_removal
Request example
Authentication and access
- Required role: GV.APIOwner
- Data classification: metadata
- Side effects: configurationWrite
- Microsoft Entra delegated user token
- Microsoft Entra application token
Parameters
sourceUuid
path Required Opaque Fabric Discovery Source UUID.string (uuid)
Opaque Fabric Discovery Source UUID.
planUuid
path Required Opaque Fabric removal-plan UUID.string (uuid)
Opaque Fabric removal-plan UUID.
Idempotency-Key
header Required Required caller-chosen retry identity. Use 1-128 visible ASCII characters and reuse it only for an exact retry of this request.string
minimum length: 1 · maximum length: 128
If-Match
header Required Exact strong ETag from the reviewed Fabric connection or removal plan. Weak validators, wildcards, and tag lists are rejected.string
maximum length: 1024
Request body
Requiredapplication/json
Schema FabricRemovalConfirmationobject
Properties
absentAssignments— Required
array<FabricAbsentAssignment>
maximum items: 32
Array items
Schema FabricAbsentAssignment
object
Properties
principalId— Required
string (uuid)
principalKind— Required
string
- Allowed values:
"application","executionFactory"
role— Required
string
- Constant:
"Viewer"
roleAssignmentId— Required
string (uuid)
Additional properties are not allowed.
observedAt— Required
string (date-time)
workspaceId— Required
string (uuid)
Additional properties are not allowed.
Responses
This guide summarizes response status codes and headers. Retrieve the deployed, authenticated OpenAPI document for the exact response body schemas and examples. The API also provides an authenticated Swagger UI; opening it in a browser does not automatically attach a bearer token. Error responses useapplication/problem+json. The response’s stable code and type map to the error-code reference.
200
Confirmation applied; inspect sourceRemoved.Headers
- ETag:
string - Idempotency-Replayed:
boolean - Location:
string
401
A valid Microsoft Entra bearer token is required.403
The authenticated principal does not have the required role.404
The resource does not exist in this tenant.409
The operation conflicts with current resource or Azure state.412
If-Match did not match the resource’s current strong ETag.422
The request is syntactically valid but semantically invalid.428
The exact current ETag is required in If-Match.429
The bounded application request rate was exceeded.Headers
- Retry-After: Seconds to wait before retrying.
integerminimum: 1
503
A required dependency is temporarily unavailable.Headers
- Retry-After: Seconds to wait before retrying.
integerminimum: 1