ProjectsTasksTask
POST Create task
Create a new task under /api/v1/project/task. The source markdown documents the request headers and body fields.
POST
/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 project_token inside the JSON body.
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.
project_token*string
Acuity Type:uuid
Default:required
Acuity UI:Project Token
Format uuid
task_name*string
Acuity Type:string
Default:required
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