ProjectsTasksTask
PUT Update task
Update an existing task under /api/v1/project/task. The source markdown documents the request headers and body fields.
PUT
/project/taskAuthorization
api-auth<api-auth>
api-token<UUID>
api-secret<api-secret>
Use the standard /api/v1 headers for this request.
Send the target id inside the JSON body. This endpoint does not use record-id.
API Credentials (save your keys here to make the request examples copy-ready)Hidden by default
Save your domain and request headers once, then reuse them across the current docs session.
Session storage clears when this tab closes. Local storage stays available the next time you open the docs in this browser.
Saved values are used in request examples and code snippets on API pages, including the request domain.
Request Body
application/json
Top-level request body type: object. Send JSON fields shown below.
id*integer
Acuity Type:bigint
Default:required
task_namestring
Acuity Type:string
Default:""
Acuity UI:Task Name
statusstring
Acuity Type:open | closed
Default:open
Acuity UI:Status
Value in "Open" | "Closed"
start_datestring
Acuity Type:date (yyyy-mm-dd)
Default:nil
Acuity UI:Start Date
Format dateNullable
finish_datestring
Acuity Type:date (yyyy-mm-dd)
Default:nil
Acuity UI:Finish Date
Format dateNullable
actual_start_datestring
Acuity Type:date (yyyy-mm-dd)
Default:nil
Acuity UI:Actual Start Date
Format dateNullable
actual_finish_datestring
Acuity Type:date (yyyy-mm-dd)
Default:nil
Acuity UI:Actual Finish Date
Format dateNullable
notesstring
Acuity Type:string
Default:""
Acuity UI:Notes
Nullable
performancestring
Acuity Type:green | yellow | red
Default:green
Acuity UI:Performance
Value in "Green" | "Yellow" | "Red"
assigned_tostring
Acuity Type:option
Default:nil
Acuity UI:Assigned To
Nullable