Tasks

Updates a task by key. Omitted body fields are left unchanged.

post/v2/tasks/{taskKey}

Request

  • Base URL
    https://api.streak.com/api
  • URL
    https://api.streak.com/api/v2/tasks/{taskKey}
  • Auth
    HTTP bearer

Path parameters

taskKeystring required

Key for the task to update.

Request body

textstring nullable

New task text. Omit this field to keep existing text unchanged.

dueDateinteger nullable

New task due date, in epoch milliseconds. Use -1 to clear the due date.

status'NOT_DONE' | 'DONE' nullable

New task completion status. Omit this field to keep existing status unchanged.

meetingKeystring nullable

Key for the meeting this task belongs to. Omit this field to keep existing meeting unchanged.

isDraftboolean nullable

Whether to publish a draft task. Omit this field to keep existing draft state unchanged.

draftboolean

Example request

{
  "dueDate": 1646870400000
}

Response

OK

keystring required

Key for this task.

boxKeystring required

Key for the box this task belongs to.

pipelineKeystring required

Key for the pipeline this task belongs to.

creatorKeystring required

Key for the user who created this task.

creationDateinteger required

Timestamp when this task was created, in epoch milliseconds.

lastSavedTimestampinteger required

Timestamp when this task was last persisted, in epoch milliseconds.

lastStatusChangeDateinteger required

Timestamp when this task status last changed, in epoch milliseconds.

dueDateinteger nullable

Task due date, in epoch milliseconds.

textstring required

Task text.

status'NOT_DONE' | 'DONE' required
reminderStatus'NONE' | 'SCHEDULED' | 'REMINDED' | 'ERROR_ON_REMINDER' | 'NOT_REMINDED_BECAUSE_TASK_DONE' required
meetingKeystring nullable

Key for the meeting this task belongs to, when any.

Example response

{
  "creationDate": 1646870400000,
  "lastSavedTimestamp": 1646870400000,
  "lastStatusChangeDate": 1646870400000,
  "dueDate": 1646870400000,
  "actions": [
    {
      "contact": {
        "creationDate": 1646870400000,
        "versionTimestamp": 1646870400000,
        "lastSavedTimestamp": 1646870400000,
        "lastEnrichmentTimestamp": 1646870400000,
        "contactLinks": [
          {
            "creationTimestamp": 1646870400000
          }
        ],
        "orgLinks": [
          {
            "creationTimestamp": 1646870400000
          }
        ]
      }
    }
  ]
}

Changes