# Report a device backup update (internal)

**POST /extraction/device/backup-update**

Desktop plumbing: records a device backup lifecycle transition (started, completed, failed or cancelled). On `completed`, charges the collection when the organization is on backup-time charging. Always 200 once handled; `billingOutcome` says what the charge dispatch did, and a declined charge is a normal outcome, never an error.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Access token


## Parameters



### Body: application/json (object)

- **systemId** (string)

- **deviceId** (string)
  Stable hardware id, not the Mongo _id

- **deviceType** (string)

- **status** (string)
  Lifecycle state being reported. Only `completed` can result in a charge.

- **reason** (string)
  Cause for failed/cancelled

- **metadata** (object)

- **appVersion** (string)



## Responses
### 200


#### Body: application/json (object)
- **data** (object)

- **statusCode** (number)

- **timestamp** (string(date-time))



[Powered by Bump.sh](https://bump.sh)