---
title: "Create a new asset status"
method: POST
path: "/assets/{assetId}/status"
tags: ["Assets"]
---

# Create a new asset status

`POST /assets/{assetId}/status`

## Path parameters

- `assetId` 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 `201`

Successfully set a new asset status

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

## Other responses

- `400` — OrganizationId was not provided
- `401` — Invalid token
- `404` — Could not find the specified asset.

---

[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)