Bulk Write Gated by Quorum

URI: https://docs.ankatech.co/errors/quorum-bulk-write-gated
HTTP Status: 409 Conflict

When you see this

A write that combines several changes asked for one the deployment quorum policy gates. Such a write cannot become one quorum request, and making the changes the quorum does not gate while the gated one waits would apply half of what was asked, so nothing was written. Two writes answer it:

• the bulk deployment-policy write (PUT /api/v3/admin/platform/deployment/policies), when it names a policy the deployment quorum gates;
• the provisioning of a tenant (POST /api/v3/admin/platform/tenants/provision) with allowsTenantOverride: true, while the deployment quorum gates granting a tenant the override of the deployment policies: no tenant, administrator or policy row is created.

Quorum (M-of-N) approval is described in Quorum Approval^*.

Common Causes

• The deployment quorum policy gates DEPLOYMENT_ALGORITHM_POLICY_CHANGE or DEPLOYMENT_ROTATION_POLICY_CHANGE, and the bulk body carries that policy.
• The deployment quorum policy gates TENANT_POLICY_OVERRIDE_GRANT, and the provisioning request asks for the override.

Response Example

{
  "type": "https://docs.ankatech.co/errors/quorum-bulk-write-gated",
  "title": "Bulk Write Gated by Quorum",
  "status": 409,
  "detail": "The deployment quorum policy gates a policy this bulk write changes; nothing was written. Change each policy through its own endpoint, where the quorum approves it.",
  "instance": "/api/v3/admin/platform/deployment/policies",
  "timestamp": 1730000000,
  "extensions": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Content-Type: application/problem+json — the response follows RFC 9457 Problem Details.

How to Resolve

1. Change each policy through its own endpoint: each answers 202 with a quorum request the platform approvers decide.
2. Or leave out of the bulk body the policies the deployment quorum gates.
3. For a provisioning, provision the tenant without allowsTenantOverride, then grant the override through the override endpoint, where the platform approvers decide it.

For full schema definitions, examples, and interactive testing, see the Developer Hub Reference.