Create and manage work orders

Use the work order endpoints to raise AssetOps work orders from external systems and keep them in sync. Each work order belongs to a building and references categories, priorities, and people from that building. Each linked endpoint can switch the sample between cURL, JavaScript, Python, and PowerShell, or send the request for you.

Before you begin

You need:

An access token. See the quickstart.
A buildingId from List buildings.
AssetOps enabled for the building.

Create a work order

Look up valid values

Work orders reference identifiers that must exist in the building. Get them from the lookup endpoints:

Field	Lookup endpoint
`category`, `issueType`	List categories and issue types
`priority`	List priorities
`vendor`	List vendors
`team`	List teams
`assignees`	List assignees

Cache these values and refresh them periodically. They change less often than work orders.

Create the work order

Send the work order to Create a work order. The API accepts CORRECTIVE_MAINTENANCE and SERVICE_REQUEST as the workType.

curl --request POST \
  "https://api.kodelabs.com/kodeos/api/v1/buildings/${BUILDING_ID}/assetops/work-orders" \
  --header "Authorization: Bearer ${KODE_ACCESS_TOKEN}" \
  --header "Content-Type: application/json" \
  --data '{
    "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",
    "category": { "id": "6501c2d3e4f5a6b7c8d9e0f1" },
    "issueType": { "id": "6501c2d3e4f5a6b7c8d9e0f2" },
    "priority": { "id": "6501c2d3e4f5a6b7c8d9e0c4" },
    "assignees": [{ "email": "dana.ruiz@example.com" }],
    "linkedSource": { "identifier": "FAULT-88231", "type": "EXTERNAL" }
  }'

Store the returned id and identifier. Set linkedSource.identifier to the record ID in your system so that you can match work orders later.

Attach files

Upload photos or documents with Upload attachments as multipart form data. If your system already holds base64 content, use Upload base64 attachments. Both endpoints accept up to 10 files per request.

Update a work order

Update a work order replaces the editable details. Optional fields you leave out, such as description, vendor, team, and assignees, can be cleared. To change one field safely:

Get the current work order with Get a work order.
Change the field you need.
Send the complete body back.

You cannot change workType or linkedSource after creation. If you omit priority, the current priority stays in place.

Sync work orders with another system

To keep an external system up to date, poll for changes instead of reading every work order:

Call List work orders with updatedAtFrom set to the time of your last sync.
Call List building comments with the same filter to collect new comments.
Filter by sourceType to return only work orders your integration created.

Store the sync time only after you process every page, so a failure does not skip changes.

Get started

Guides

API reference

Before you begin

Create a work order

Update a work order

Sync work orders with another system

​Before you begin

​Create a work order

​Update a work order

​Sync work orders with another system

Before you begin

Create a work order

Update a work order

Sync work orders with another system