Skip to main content
POST
/
tasks
/
{taskId}
/
subtasks
Create a subtask
curl --request POST \
  --url https://api.smokeball.com/tasks/{taskId}/subtasks \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json-patch+json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "staffId": "750eb5c5-ac0b-7d11-4997-e0ce9d8896c8",
  "subject": "Confer with Mary",
  "completedByStaffId": "750eb5c5-ac0b-7d11-4997-e0ce9d8896c8",
  "isCompleted": false,
  "completedDate": "2020-02-15T13:00:00Z",
  "completedDateOnly": "2020-02-15"
}
'
{
  "id": "<string>",
  "href": "<string>",
  "relation": "<string>",
  "method": "GET"
}

Authorizations

ā€‹
x-api-key
string
header
required
ā€‹
Authorization
string
header
required

Path Parameters

ā€‹
taskId
string<uuid>
required

Body

Data transfer object for a subtask.

ā€‹
staffId
string
required

Unique identifier of the associated staff member creating or updating the subtask.

Minimum string length: 1
Example:

"750eb5c5-ac0b-7d11-4997-e0ce9d8896c8"

ā€‹
subject
string
required

Subject of the subtask.

Minimum string length: 1
Example:

"Confer with Mary"

ā€‹
completedByStaffId
string | null

Unique identifier of the associated staff member who completed the subtask.

Example:

"750eb5c5-ac0b-7d11-4997-e0ce9d8896c8"

ā€‹
isCompleted
boolean

True when the subtask is completed.

Example:

false

ā€‹
completedDate
string<date-time> | null
deprecated

Deprecated. Use CompletedDateOnly instead.

Completed date of the subtask in UTC. If not provided and IsCompleted is set to true, the current date will be used.

Example:

"2020-02-15T13:00:00Z"

ā€‹
completedDateOnly
string<date-time> | null

Completed date of the subtask. Takes precendence over CompletedDate if set. If not provided and IsCompleted is set to true, the current date will be used.

Any time/timezone information will be discarded and only the date portion will be considered.

Example:

"2020-02-15"

Response

When request is accepted. Returns a hypermedia 'Link' object of the subtask to be created.

ā€‹
id
string | null
ā€‹
href
string | null
ā€‹
relation
string | null
ā€‹
method
string | null
default:GET