---
title: "Update asset status"
method: PATCH
path: "/assetstatuses/{id}"
tags: ["Asset Statuses"]
---

# Update asset status

`PATCH /assetstatuses/{id}`

## Path parameters

- `id` integer, required

## Query parameters

- `skipWebhook` boolean

## Headers

- `x-organization-id` integer

## Request body

- object
  - `status` 'IGNORE' | 'OFFLINE' | 'ONLINE' — Asset status value.
  - `customStatusId` number, nullable — Id of the custom status assigned to asset.
  - `downtimeType` 'PLANNED' | 'UNPLANNED', nullable
  - `startedAt` string, date-time — Asset status effective start date.
  - `endedAt` string, date-time, nullable — Asset status effective end date.
  - `description` string, nullable

## Response `200`

Successfully edited asset status

- object
  - `assetStatus` object, required
    - `id` number, required — Global ID of the asset status.
    - `customStatusId` number, nullable — Id of the custom status assigned to asset.
    - `status` 'IGNORE' | 'OFFLINE' | 'ONLINE' — Asset status value.
    - `downtimeType` 'PLANNED' | 'UNPLANNED', nullable
    - `startedAt` string, date-time, required — Asset status effective start date.
    - `endedAt` string, date-time, nullable — Asset status effective end date.
    - `description` string, nullable
    - `createdAt` string, date-time — Date & time at which the asset status was created.
    - `updatedAt` string, date-time — Date & time at which the asset status was last updated.
    - `deletedAt` string, date-time, nullable — Date & time at which the asset status was deleted.

## Other responses

- `400` — OrganizationId was not provided
- `401` — Invalid token
- `403` — Failed to edit the asset status
- `404` — Could not find the specified assetstatus.

---

[API](https://skmtc.net/getmaintainx/apis/maintainx-api.md) · [All operations](https://skmtc.net/getmaintainx/apis/maintainx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getmaintainx/maintainx-api/revisions/ef9153fcac7c/schema)