---
title: "Update a task"
method: PUT
path: "/tasks-open-api/{taskId}"
tags: ["Tasks"]
---

# Update a task

`PUT /tasks-open-api/{taskId}`

## Path parameters

- `taskId` string, required

## Request body

- object
  - `title` string — The name you call the task
  - `description` string — Add any additional information needed to define the task.
  - `priority` 'medium' | 'high' | 'low' — Priority value
  - `type` 'cleaning' | 'maintenance' | 'inspection' | 'mid-stay' | 'runner' | 'sanitation' | 'check-in' | 'issue' | 'inventory' | 'administration' — Task types help you with better identification and reporting.
  - `assigneeGroup` string[] — The team the assignees are part of. This is a tag.
  - `assigneeId` string — The unique Guesty identifier of the person assigned to the task.
  - `supervisorId` string — The unique Guesty identifier of the person assigned to supervise the task.
  - `checklist` string[] — A list of action items that help define the task.
  - `attachments` object[] — The place to attach external files needed for the task.
    - `url` string — URL location of the attached file.
    - `title` string — Title name of the attached file.
    - `mimetype` string — State the kind of file attached
    - `size` number — The storage size of the attachment
    - `client` string — Add any additional information needed to define the task.
  - `startTime` string, date-time — The date and time the task must begin (specific task). Each task scheduling should be set for fixed or flexible time. If “startTime” has value, leave “canStartFrom” and “mustFinishBefore” blank, and vice versa
  - `canStartAfter` string, date-time — The date and the time after which the task can begin (flexible task). Each task scheduling should be set for fixed or flexible time. If “startTime” has value, leave “canStartFrom” and “mustFinishBefore” blank, and vice versa
  - `mustFinishBefore` string, date-time — The date and time before which the task must be completed (flexible task). Each task scheduling should be set for fixed or flexible time. If “startTime” has value, leave “canStartFrom” and “mustFinishBefore” blank, and vice versa
  - `listingId` string — The object ID of the Guesty listing the task is attached to
  - `reservationId` string — The object ID of the Guesty reservation the task is attached to
  - `comments` object[]
    - `_id` string — Comment identifier for update specific comment
    - `text` string — Textual comment
    - `attachments` object[]
      - `name` string
      - `url` string
  - `status` 'pending' | 'confirmed' | 'in progress' | 'completed' | 'canceled'
  - `plannedDuration` number — The amount of time budgeted for the task (hours).
  - `expenses` object[] — To update existing expenses add existing state of expenses with ids and add changes. To add new expenses, add expenses without id fields
    - `id` string
    - `name` string, required — Expense name.
    - `category` 'advertising' | 'cleaning' | 'electricity' | 'furniture_appliances' | 'gas' | 'internet' | 'lock_automation' | 'management' | 'mortgage' | 'pest_control' | 'pool_cleaning' | 'property_taxes' | 'repairs_maintenance' | 'supplies_purchases' | 'other_misc' | 'taxes_paid' | 'telephone' | 'television' | 'trash' | 'water_septic' | 'guest_cleaning' | 'owner_cleaning' | 'channel_commission' | 'payment_charge' | 'pet_fee' | 'startup_fee' | 'fotoshoot' | 'vat', required — Expense category
    - `description` string — Expense description
    - `amount` number, required — Amount value
    - `recognitionDate` string, date — Expense recognition date. ISO 8601 Date format (year-month-day). If no date provided, will be used date of task creation.
    - `vendorId` string, required — You can get your vendor ID [here](/reference/vendorscontroller_getall)
    - `shareSplit` number, required — A share split is a floating point number that represents the percentage. For example, - \`0.5\` means that the share is 50% between PMC and Owner. - \`0.1\` means that the share is 10% Owner and 90% PMC. - \`0\` means that the charge covered 100% by PMC.
    - `attachments` object — Add attachments to expense.
      - `id` string
      - `url` string, required — URL to CDN where attachment is stored. Max length is 2048 characters
      - `extension` string, required — Attachment file extension. Max length is 10 characters
      - `fileName` string, required — Attachment file name. Max length is 256 characters

## Response `200`

Successful operation

## Other responses

- `400` — Bad request
- `403` — Forbidden

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/revisions/7c62644070f2/schema)