Skip to content
HeyX API

Complete Work Order

Required scope: work_order:complete

Transition a work order to the completed state. The API key creator must have current access to its customer. Completing a work order that is already completed returns its current state without repeating any side effects.

Generated Reference
POST /public-api/publicapi.v1.WorkOrder/CompleteWorkOrder

Marks a work order completed. Blocked when the work order has incomplete tasks or advanced tasks. Terminal and not idempotent; completing an already-completed work order returns it unchanged without re-emitting.

Request CompleteWorkOrderRequest
Response CompleteWorkOrderResponse

CompleteWorkOrderRequest

Field Type Description
id string Identifies the work order to complete. Must be visible to the API key actor.

CompleteWorkOrderResponse

Field Type Description
work_order WorkOrder The work order after completion.

Related Types

WorkOrder

Field Type
id string
customer_id string
title string
description string
status string
created_at int64
updated_at int64
customer_reference_number string
customer_title string
total_tasks int32
completed_tasks int32
work_order_template_id optional string

Request

Section titled “Request”
{
  "id": "<work-order-id>"
}

Response

Section titled “Response”
{
  "workOrder": {
    "id": "<work-order-id>",
    "title": "Install replacement inverter",
    "status": "completed"
  }
}

This is not idempotent; do not blindly retry a timed-out call.

HeyX API