Skip to main content
PUT
/
v1
/
projects
/
{PROJECT_ID}
/
lists
/
{LIST_ID}
/
tasks
Create a task
curl --request PUT \
  --url https://api.domo.com/v1/projects/{PROJECT_ID}/lists/{LIST_ID}/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "3",
  "projectId": "2",
  "projectListId": "4",
  "taskName": "Business Plan Review",
  "priority": 3,
  "contributors": [
    27
  ],
  "tags": [],
  "archived": false
}
'
{
  "id": "5",
  "projectId": "2",
  "projectListId": "4",
  "taskName": "Business Plan Review",
  "createdDate": "2018-08-01T08:00:00Z",
  "updatedDate": "2018-08-01T08:00:00Z",
  "priority": 3,
  "createdBy": 27,
  "ownedBy": 27,
  "contributors": [
    27
  ],
  "attachmentCount": 0,
  "tags": [],
  "archived": false
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
PROJECT_ID
string
required

The ID of the project

​
LIST_ID
string
required

The ID of the list

Query Parameters

​
taskName
string
required

The name of the task

​
description
string

An optional description of the task

​
dueDate
string

The date the task is expected to be completed

​
priority
integer

Priority of task within a list. Setting this property will impact the index of other tasks in the list to maintain sequential order. If not provided the priority will default to 1 and the index of all the other tasks in the list will shift.

​
ownedBy
integer

The ID of the Domo user that owns the task

​
contributors
integer

An array of user IDs that are assigned as contributors to the task

​
tags
string

An array of tags that have been assigned to the task

​
OFFSET
integer

The maximum amount of results to return (defaults to 10 with a maximum of 50)

​
LIMIT
integer

The number of records to offset from the beginning of the result list (defaults to 0)

Body

application/json

The request body accepts a task object.

​
id
string
​
projectId
string
​
projectListId
string
​
taskName
string
​
priority
integer
​
contributors
integer[]
​
tags
object[]
​
archived
boolean

Response

200 - application/json

Returns the task object.

​
id
string
​
projectId
string
​
projectListId
string
​
taskName
string
​
createdDate
string
​
updatedDate
string
​
priority
integer
​
createdBy
integer
​
ownedBy
integer
​
contributors
integer[]
​
attachmentCount
integer
​
tags
object[]
​
archived
boolean