---
title: "Update the signed-in account's box to the available version"
method: POST
path: "/api/managed/allocation/update"
tags: ["nodes"]
---

# Update the signed-in account's box to the available version

`POST /api/managed/allocation/update`

## Request

- Base URL: `https://app.nerdit.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://app.nerdit.ai/api/managed/allocation/update`
- Auth: none declared

Record the owner's update; the provisioner performs it. No id is taken.

``202`` once accepted, and again (nothing written) while it runs.
``409`` while the box is offline or busy, up to date, offered another
version, or being backed up; ``429`` within 3 minutes of the previous
accepted click. Nothing is ever forced and never downgraded.

## Request body

- ManagedUpdateRequest
  - `version` string, required

## Response `202`

Successful Response

- ManagedUpdateView: Where the box's daemon version stands against the box template's.
  - `current` string, nullable, required
  - `available` string, nullable, required
  - `supported` boolean, required
  - `updating_to` string, nullable, required
  - `last` ManagedUpdateResultView, required: The newest update attempt that did not succeed.
    - `outcome` 'failed' | 'not_started', required
    - `version` string, required
    - `at` string, date-time, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Too Many Requests

---

[API](https://skmtc.dev/nerdit/apis/nerdit-cloud-web.md) · [All operations](https://skmtc.dev/nerdit/apis/nerdit-cloud-web/llms.txt) · [OpenAPI document](https://skmtc.dev/nerdit/apis/nerdit-cloud-web/revisions/06e3b44b58be?raw)