> ## Documentation Index > Fetch the complete documentation index at: https://docs.kodelabs.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a work order > Creates a corrective maintenance or service request work order. Get valid `category`, `issueType`, `vendor`, `team`, `priority`, and `assignees` identifiers from the lookup endpoints first. See [Manage work orders](https://docs.kodelabs.com/products/kode-api/guides/manage-work-orders.md). ## OpenAPI ````yaml /openapi/kode-api.yaml post /api/v1/buildings/{buildingId}/assetops/work-orders openapi: 3.1.0 info: title: KODE API version: 1.0.0 summary: Programmatic access to KODE OS resources and operations. description: > Use the KODE API to work with buildings, data sources, connectors, devices, points, virtual devices, timeseries data, schedules, the ontology, templating, mass writes, spaces, space assignments, tenants, meters, users, actions, and AssetOps work orders. license: name: Proprietary identifier: LicenseRef-Proprietary servers: - url: https://api.kodelabs.com/kodeos description: KODE API security: - bearerAuth: [] tags: - name: Authentication description: OAuth 2.0 discovery, token, and revocation endpoints. - name: Buildings description: Buildings and their areas. - name: Data sources description: Data sources connected to a building. - name: Devices description: Devices and their points. - name: Points description: Point queries and point writes. - name: Timeseries description: Current and historical point values. - name: Actions description: Actions exposed by building data sources. - name: Work orders description: AssetOps work orders, lookups, comments, and attachments. - name: Connectors description: KODE API connectors and the devices and points ingested through them. - name: Schedules description: Schedules discovered on building data sources. - name: Templating description: Apply ontology templates to groups of points. - name: Virtual devices description: Virtual devices that group points from other devices. - name: Ontology description: Canonical types, fields, units, and connections of the KODE ontology. - name: Users description: Users of the organization and their app access. - name: Mass write description: Write values to many points across buildings, and follow each run. - name: Spaces description: Levels and space units of a building, and the meters located in them. - name: Space assignments description: Assign tenants to leasable spaces of a building for a period. - name: Tenants description: Tenants of a building, the people or companies that lease its spaces. - name: Meters description: >- Meters of a building, their space assignments, parent and child links, and readings. paths: /api/v1/buildings/{buildingId}/assetops/work-orders: post: tags: - Work orders summary: Create a work order description: Creates a corrective maintenance or service request work order. operationId: createWorkOrder parameters: - $ref: '#/components/parameters/BuildingId' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/WorkOrderCreate' responses: '200': description: The created work order. content: application/json: schema: $ref: '#/components/schemas/WorkOrder' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/TooManyRequests' components: parameters: BuildingId: name: buildingId in: path required: true description: Building identifier from List buildings. schema: type: string example: 67c960faffaa42223163099e schemas: WorkOrderCreate: allOf: - type: object required: - workType properties: workType: type: string enum: - CORRECTIVE_MAINTENANCE - SERVICE_REQUEST example: CORRECTIVE_MAINTENANCE linkedSource: type: object description: Link to a record in an external system. required: - identifier properties: identifier: type: string example: FAULT-88231 type: type: string example: EXTERNAL - $ref: '#/components/schemas/WorkOrderUpdate' WorkOrder: type: object title: Work order properties: id: type: string example: 6702c4e1b8a3f21d9c0e4a17 identifier: type: string description: Human-readable work order number. example: WO-1042 createdAt: type: string example: 2026-10-07T14:02:11+0000 updatedAt: type: string example: 2026-10-07T14:02:11+0000 status: $ref: '#/components/schemas/WorkOrderStatus' workType: type: string enum: - PM - INSPECTION - CORRECTIVE_MAINTENANCE - SERVICE_REQUEST - COMPLIANCE_MAINTENANCE example: CORRECTIVE_MAINTENANCE title: type: string example: Replace AHU-01 supply fan belt description: type: string example: Belt is worn and slipping during morning startup. startDate: type: string example: '2026-10-08T09:00:00' dueDate: type: string example: '2026-10-10T17:00:00' completedDate: type: - string - 'null' example: null linkedSource: type: object properties: identifier: type: string example: FAULT-88231 totalLogHours: type: object properties: hours: type: integer example: 0 minutes: type: integer example: 0 statusLogs: type: array items: type: object properties: status: $ref: '#/components/schemas/WorkOrderStatus' updatedAt: type: string example: 2026-10-07T14:02:11+0000 furtherReview: type: boolean example: false assignees: type: array items: $ref: '#/components/schemas/UserSummary' WorkOrderUpdate: type: object required: - startDate - title - category - issueType properties: title: type: string maxLength: 1000 example: Replace AHU-01 supply fan belt description: type: string maxLength: 10000 example: Belt is worn and slipping during morning startup. startDate: type: string example: '2026-10-08T09:00:00' dueDate: type: string example: '2026-10-10T17:00:00' category: $ref: '#/components/schemas/Selection' issueType: $ref: '#/components/schemas/Selection' priority: $ref: '#/components/schemas/Selection' vendor: $ref: '#/components/schemas/Selection' team: $ref: '#/components/schemas/Selection' assignees: type: array description: Assign by user `id` or `email`. items: type: object properties: id: type: string example: 64f1a2b3c4d5e6f708192a3b email: type: string format: email example: dana.ruiz@example.com WorkOrderStatus: type: string enum: - OPEN - IN_PROGRESS - FOR_REVIEW - ON_HOLD - COMPLETED - CANCELLED - FAILED example: OPEN UserSummary: type: object properties: id: type: string example: 64f1a2b3c4d5e6f708192a3b firstName: type: string example: Dana lastName: type: string example: Ruiz email: type: string format: email example: dana.ruiz@example.com Selection: type: object required: - id properties: id: type: string description: Identifier from the matching lookup endpoint. example: 6501c2d3e4f5a6b7c8d9e0f1 name: type: string responses: BadRequest: description: The request is invalid. Check required fields, types, and limits. Unauthorized: description: The access token is missing, invalid, or expired. Request a new token. Forbidden: description: The service account lacks permission for this building or operation. NotFound: description: The resource does not exist or is not assigned to the service account. TooManyRequests: description: >- A rate-limit window is exhausted. Wait, then retry with increasing delays. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Paste an access token from [Create an access token](/products/kode-api/api-reference/authentication/create-an-access-token). Tokens expire, so request a new one if you receive `401`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.