Create a work order

Create a work order

curl --request POST \
  --url https://api.kodelabs.com/kodeos/api/v1/buildings/{buildingId}/assetops/work-orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workType": "CORRECTIVE_MAINTENANCE",
  "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: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    workType: 'CORRECTIVE_MAINTENANCE',
    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', 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"

payload = {
    "workType": "CORRECTIVE_MAINTENANCE",
    "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.post(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' -Method POST -Headers $headers -ContentType 'application/json' -Body '{
  "workType": "CORRECTIVE_MAINTENANCE",
  "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"
    }
  ]
}

POST

https://api.kodelabs.com/kodeos

api

buildings

{buildingId}

assetops

work-orders

Create a work order

curl --request POST \
  --url https://api.kodelabs.com/kodeos/api/v1/buildings/{buildingId}/assetops/work-orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workType": "CORRECTIVE_MAINTENANCE",
  "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: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    workType: 'CORRECTIVE_MAINTENANCE',
    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', 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"

payload = {
    "workType": "CORRECTIVE_MAINTENANCE",
    "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.post(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' -Method POST -Headers $headers -ContentType 'application/json' -Body '{
  "workType": "CORRECTIVE_MAINTENANCE",
  "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"
    }
  ]
}

Get valid category, issueType, vendor, team, priority, and assignees identifiers from the lookup endpoints first. See Manage work orders.

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.

Body

application/json

workType

enum<string>

required

Available options:

CORRECTIVE_MAINTENANCE,

SERVICE_REQUEST

Example:

"CORRECTIVE_MAINTENANCE"

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 created 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