/api/v1/validation-tests/{validationTestUuid}
Soft-deactivates the Test while preserving its public identity, immutable versions, Runs, and Results. Requires the GV.APIContributor application role, or a higher role (Owner > Contributor > Reader).
Operation ID · deactivate_validation_test
Request example
Authentication and access
- Required role: GV.APIContributor
- Data classification: metadata
- Side effects: configurationWrite
- Microsoft Entra delegated user token
- Microsoft Entra application token
Parameters
validationTestUuid
path Required Opaque Validation Test UUID.string (uuid)
Opaque Validation Test UUID.
If-Match
header Required Exact strong ETag from the current Validation Test. Weak validators, wildcards, and tag lists are rejected.string
maximum length: 1024
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.
204
Validation Test deactivated.Headers
- ETag:
string
401
A valid Microsoft Entra bearer token is required.402
The organization entitlement does not permit this mutation.403
The authenticated principal does not have the required role.404
The resource does not exist in this tenant.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