Skip to content

Instance Not Claimed

URI: https://docs.ankatech.co/errors/instance-not-claimed
HTTP Status: 409 Conflict

When you see this

Deployment-ownership recovery (envctl.sh <env> recover-platform-access --identity <email>) ran on an environment nobody has claimed yet. A new environment holds no platform administrator: the first one is created by the instance claim, never by a recovery. Nothing was changed, the refusal was recorded in the audit trail, and the command exits non-zero printing the detail.

Common Causes

  • The environment was created and deployed, and the claim code was never minted or never redeemed.

Response Example

{
  "type": "https://docs.ankatech.co/errors/instance-not-claimed",
  "title": "Instance Not Claimed",
  "status": 409,
  "detail": "This instance has not been claimed yet, so there is no platform administrator to recover. Mint a claim code with envctl.sh <env> claim-code and claim the instance from the console. Nothing was changed.",
  "instance": "/api/v3/admin/platform/ownership-recovery",
  "timestamp": 1792236600,
  "extensions": {
    "requestId": "9d3c1e7a-5b2f-4a86-8c04-6e1f2a9b7d35"
  }
}

Content-Type: application/problem+json — the response follows RFC 9457 Problem Details. This is an Admin API body, so the correlation identifier is extensions.requestId; see Error Index & Overview.

How to Resolve

  1. Mint a claim code on the environment host:

    sudo /opt/ankatech/admin/envctl.sh <env> claim-code

  2. Enter it on the console's claim screen, on the Management origin, with the e-mail address of the first platform administrator. See First-Run Provisioning*.

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

* restricted content — see higher-tier documentation