PATCH /api/v2/it_asset_management/statuses/{status_id}

Updates an existing status. Standard (system-defined) statuses cannot be modified.

Allowed For

Servers

Path parameters

Name Type Required Description
status_id String Yes

The id of the asset status

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
status Object No
status.category String No

The status category. One of available, in_use, unavailable, or end_of_life

Valid values:

  • "end_of_life"
  • "available"
  • "unavailable"
  • "in_use"
status.external_id String No

An id you can use to connect a status to external data

status.name String No

Display name for the status

status.description String No

Description of the status

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.