Deployment Policy Locked

URI: https://docs.ankatech.co/errors/locked-deployment-policy
HTTP Status: 409 Conflict

When you see this

The deployment policy is locked and cannot be modified. Locked policies are fixed for the deployment and reject mutation attempts.

Common Causes

• Editing a policy that has been locked at the deployment level.
• Attempting to override a setting fixed by the deployment license or operator.
• A change to a policy field marked immutable for this deployment.

Response Example

{
  "type": "https://docs.ankatech.co/errors/locked-deployment-policy",
  "title": "Deployment Policy Locked",
  "status": 409,
  "detail": "The deployment policy is locked and cannot be modified.",
  "instance": "/api/v3/admin/deployment/policy",
  "correlationId": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": 1730000000
}

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

How to Resolve

1. Confirm whether the policy is locked for this deployment.
2. If the change is legitimately required, request an operator or deployment-level change.
3. Do not retry the mutation against the locked policy.

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