Update a work order

Update a work order

curl --request PUT \
  --url https://api.kodelabs.com/kodeos/api/v1/buildings/{buildingId}/assetops/work-orders/{workOrderId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Replace AHU-01 supply fan belt",
  "startDate": "2026-10-08T09:00:00",
  "category": {
    "id": "6501c2d3e4f5a6b7c8d9e0f1",
    "name": "<string>"
  },
  "issueType": {
    "id": "6501c2d3e4f5a6b7c8d9e0f1",
    "name": "<string>"
  }
}
'

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: 'Replace AHU-01 supply fan belt',
    startDate: '2026-10-08T09:00:00',
    category: {id: '6501c2d3e4f5a6b7c8d9e0f1', name: '<string>'},
    issueType: {id: '6501c2d3e4f5a6b7c8d9e0f1', name: '<string>'}
  })
};

fetch('https://api.kodelabs.com/kodeos/api/v1/buildings/{buildingId}/assetops/work-orders/{workOrderId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.kodelabs.com/kodeos/api/v1/buildings/{buildingId}/assetops/work-orders/{workOrderId}"

payload = {
    "title": "Replace AHU-01 supply fan belt",
    "startDate": "2026-10-08T09:00:00",
    "category": {
        "id": "6501c2d3e4f5a6b7c8d9e0f1",
        "name": "<string>"
    },
    "issueType": {
        "id": "6501c2d3e4f5a6b7c8d9e0f1",
        "name": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

$headers=@{}
$headers.Add("Authorization", "Bearer <token>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://api.kodelabs.com/kodeos/api/v1/buildings/{buildingId}/assetops/work-orders/{workOrderId}' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{
  "title": "Replace AHU-01 supply fan belt",
  "startDate": "2026-10-08T09:00:00",
  "category": {
    "id": "6501c2d3e4f5a6b7c8d9e0f1",
    "name": "<string>"
  },
  "issueType": {
    "id": "6501c2d3e4f5a6b7c8d9e0f1",
    "name": "<string>"
  }
}'

{
  "id": "6702c4e1b8a3f21d9c0e4a17",
  "identifier": "WO-1042",
  "createdAt": "2026-10-07T14:02:11+0000",
  "updatedAt": "2026-10-07T14:02:11+0000",
  "status": "OPEN",
  "workType": "CORRECTIVE_MAINTENANCE",
  "title": "Replace AHU-01 supply fan belt",
  "description": "Belt is worn and slipping during morning startup.",
  "startDate": "2026-10-08T09:00:00",
  "dueDate": "2026-10-10T17:00:00",
  "completedDate": null,
  "linkedSource": {
    "identifier": "FAULT-88231"
  },
  "totalLogHours": {
    "hours": 0,
    "minutes": 0
  },
  "statusLogs": [
    {
      "status": "OPEN",
      "updatedAt": "2026-10-07T14:02:11+0000"
    }
  ],
  "furtherReview": false,
  "assignees": [
    {
      "id": "64f1a2b3c4d5e6f708192a3b",
      "firstName": "Dana",
      "lastName": "Ruiz",
      "email": "dana.ruiz@example.com"
    }
  ]
}

PUT

https://api.kodelabs.com/kodeos

api

buildings

{buildingId}

assetops

work-orders

{workOrderId}

Update a work order

curl --request PUT \
  --url https://api.kodelabs.com/kodeos/api/v1/buildings/{buildingId}/assetops/work-orders/{workOrderId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Replace AHU-01 supply fan belt",
  "startDate": "2026-10-08T09:00:00",
  "category": {
    "id": "6501c2d3e4f5a6b7c8d9e0f1",
    "name": "<string>"
  },
  "issueType": {
    "id": "6501c2d3e4f5a6b7c8d9e0f1",
    "name": "<string>"
  }
}
'

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: 'Replace AHU-01 supply fan belt',
    startDate: '2026-10-08T09:00:00',
    category: {id: '6501c2d3e4f5a6b7c8d9e0f1', name: '<string>'},
    issueType: {id: '6501c2d3e4f5a6b7c8d9e0f1', name: '<string>'}
  })
};

fetch('https://api.kodelabs.com/kodeos/api/v1/buildings/{buildingId}/assetops/work-orders/{workOrderId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.kodelabs.com/kodeos/api/v1/buildings/{buildingId}/assetops/work-orders/{workOrderId}"

payload = {
    "title": "Replace AHU-01 supply fan belt",
    "startDate": "2026-10-08T09:00:00",
    "category": {
        "id": "6501c2d3e4f5a6b7c8d9e0f1",
        "name": "<string>"
    },
    "issueType": {
        "id": "6501c2d3e4f5a6b7c8d9e0f1",
        "name": "<string>"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

$headers=@{}
$headers.Add("Authorization", "Bearer <token>")
$headers.Add("Content-Type", "application/json")
$response = Invoke-WebRequest -Uri 'https://api.kodelabs.com/kodeos/api/v1/buildings/{buildingId}/assetops/work-orders/{workOrderId}' -Method PUT -Headers $headers -ContentType 'application/json' -Body '{
  "title": "Replace AHU-01 supply fan belt",
  "startDate": "2026-10-08T09:00:00",
  "category": {
    "id": "6501c2d3e4f5a6b7c8d9e0f1",
    "name": "<string>"
  },
  "issueType": {
    "id": "6501c2d3e4f5a6b7c8d9e0f1",
    "name": "<string>"
  }
}'

{
  "id": "6702c4e1b8a3f21d9c0e4a17",
  "identifier": "WO-1042",
  "createdAt": "2026-10-07T14:02:11+0000",
  "updatedAt": "2026-10-07T14:02:11+0000",
  "status": "OPEN",
  "workType": "CORRECTIVE_MAINTENANCE",
  "title": "Replace AHU-01 supply fan belt",
  "description": "Belt is worn and slipping during morning startup.",
  "startDate": "2026-10-08T09:00:00",
  "dueDate": "2026-10-10T17:00:00",
  "completedDate": null,
  "linkedSource": {
    "identifier": "FAULT-88231"
  },
  "totalLogHours": {
    "hours": 0,
    "minutes": 0
  },
  "statusLogs": [
    {
      "status": "OPEN",
      "updatedAt": "2026-10-07T14:02:11+0000"
    }
  ],
  "furtherReview": false,
  "assignees": [
    {
      "id": "64f1a2b3c4d5e6f708192a3b",
      "firstName": "Dana",
      "lastName": "Ruiz",
      "email": "dana.ruiz@example.com"
    }
  ]
}

This is a full update. Omitted optional fields such as description, vendor, team, and assignees can be cleared. Omitting priority keeps the current priority.

Get the work order first, change only the fields you need, then send the complete body.

Authorizations

Authorization

string

header

required

Paste an access token from Create an access token. Tokens expire, so request a new one if you receive 401.

Path Parameters

buildingId

string

required

Building identifier from List buildings.

workOrderId

string

required

Work order identifier.

Body

application/json

title

string

required

Maximum string length: 1000

Example:

"Replace AHU-01 supply fan belt"

startDate

string

required

Example:

"2026-10-08T09:00:00"

Response

The updated work order.

string

Example:

"6702c4e1b8a3f21d9c0e4a17"

identifier

string

Human-readable work order number.

Example:

"WO-1042"

createdAt

string

Example:

"2026-10-07T14:02:11+0000"

updatedAt

string

Example:

"2026-10-07T14:02:11+0000"

status

enum<string>

Available options:

OPEN,

IN_PROGRESS,

FOR_REVIEW,

ON_HOLD,

COMPLETED,

CANCELLED,

FAILED

Example:

"OPEN"

workType

enum<string>

Available options:

PM,

INSPECTION,

CORRECTIVE_MAINTENANCE,

SERVICE_REQUEST,

COMPLIANCE_MAINTENANCE

Example:

"CORRECTIVE_MAINTENANCE"

title

string

Example:

"Replace AHU-01 supply fan belt"

description

string

Example:

"Belt is worn and slipping during morning startup."

startDate

string

Example:

"2026-10-08T09:00:00"

dueDate

string

Example:

"2026-10-10T17:00:00"

completedDate

string | null

Example:

null

linkedSource

object

Show child attributes

totalLogHours

object

Show child attributes

statusLogs

object[]

Show child attributes

furtherReview

boolean

Example:

false

assignees

object[]

Show child attributes

Get started

Guides

API reference

Authorizations

Path Parameters

Body

Response