---
title: "Post Work Order"
method: POST
path: "/work-orders"
tags: ["WorkOrders"]
---

# Post Work Order

`POST /work-orders`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/work-orders`
- Auth: `appAuth` (a scheme the document does not define)

Create a new Work Order in Alto

## Headers

- `AgencyRef` string, required

## Request body

- AltoPropertyManagementApiModelsRequestsCreateWorkOrderRequest: Represents a work order
  - `propertyId` string, required: The unique identifier for the property associated with the work order.
  - `summary` string, required: The title of the work order.
  - `description` string, nullable: A detailed description of the work order.
  - `notes` string, nullable: Additional notes.
  - `priority` string, required: The priority level of the work order.
  - `reporterDetails` AltoPropertyManagementApiModelsWorkOrderActor
    - `type` string, nullable: A string description of the related party
    - `id` string, nullable: The unique identifier for the related party, or null for Agency
  - `accessDetails` AltoPropertyManagementApiModelsWorkOrderActor
    - `type` string, nullable: A string description of the related party
    - `id` string, nullable: The unique identifier for the related party, or null for Agency
  - `chargeDetails` AltoPropertyManagementApiModelsWorkOrderActor
    - `type` string, nullable: A string description of the related party
    - `id` string, nullable: The unique identifier for the related party, or null for Agency
  - `reportedDate` string, required: The date the work order was reported.
  - `startDate` string, nullable: The preferred start date for the works to be carried out.
  - `supplierContactId` string, nullable: The unique identifier for the supplier (recorded in Alto) who will carry out the works.
  - `quote` number, double, nullable: The estimated cost of the works.
  - `negotiatorId` string, nullable: The unique identifier of the negotiator

## Response `201`

Returns the new Work Order

- AltoPropertyManagementApiModelsResponsesWorkOrder
  - `id` string, nullable: Id of the Work Order
  - `propertyId` string, nullable: The unique identifier for the Property associated with the Work Order.
  - `supplierContactId` string, nullable: The unique identifier for the Supplier associated with the Work Order.
  - `accessDetails` AltoPropertyManagementApiModelsWorkOrderActor
    - `type` string, nullable: A string description of the related party
    - `id` string, nullable: The unique identifier for the related party, or null for Agency
  - `reporterDetails` AltoPropertyManagementApiModelsWorkOrderActor
    - `type` string, nullable: A string description of the related party
    - `id` string, nullable: The unique identifier for the related party, or null for Agency
  - `chargeDetails` AltoPropertyManagementApiModelsWorkOrderActor
    - `type` string, nullable: A string description of the related party
    - `id` string, nullable: The unique identifier for the related party, or null for Agency
  - `reportedDate` string, date-time: The date the Work Order was reported.
  - `startDate` string, date-time, nullable: The preferred start date for the work to be carried out.
  - `quote` number, double, nullable: The estimated cost of the work
  - `workOrderNumber` string, nullable: Unique Work Order reference number
  - `status` string, nullable: Current status of the Work Order
  - `summary` string, nullable: The title of the Work Order.
  - `description` string, nullable: A detailed description of the Work Order.
  - `notes` string, nullable: Additional notes.
  - `priority` string, nullable: The priority level of the Work Order.
  - `modifiedDate` string, date-time, nullable: The date the Work Order was last modified.

## Other responses

- `400`: Validation errors e.g. "Invalid ReportedDate"

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)