---
title: "Status"
method: PUT
path: "/brain/uploads/status"
---

# Status

`PUT /brain/uploads/status`

## Request

- Base URL: `https://api.heygradon.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.heygradon.com/brain/uploads/status`
- Auth: none declared

## Request body

- Status
  - `state` 'uploading' | 'offline' | 'paused' | 'done', required
  - `total` integer, required
  - `done` integer, required
  - `failed` integer, required
  - `version` string, nullable
  - `failures` Failure[], nullable
    - `path` string, required
    - `reason` string, required
  - `bytes_total` integer, nullable
  - `bytes_done` integer, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `3d596282064d`: 2 info
  - added the new optional request property `bytes_done`
  - added the new optional request property `bytes_total`

[Operation history](https://skmtc.dev/heygradon/apis/gradon-brain/changes/brain/uploads/status/put.md)

---

[API](https://skmtc.dev/heygradon/apis/gradon-brain.md) - [All operations](https://skmtc.dev/heygradon/apis/gradon-brain/llms.txt) - [OpenAPI document](https://skmtc.dev/heygradon/apis/gradon-brain/revisions/3d596282064d?raw)