---
updatedAt: 2025-12-04T00:03:11.000Z
agentTools:
  projectIndex: https://streak.readme.io/llms.txt
---

# Update a task

This call lets you edit a specific [task](reference#read-a-task).

The post data for this request must be a well formed JSON object. The properties of the JSON object determine what properties of the task get updated. The following are the allowable properties for that JSON object. All other properties will be ignored.

> 🚧 Content Type and Auth
>
> Make sure to include `-H "Content-Type: application/json"` and your authorization in any request you make on your own.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "DIRECTORY FIELDS",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://api.streak.com/api/v2"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/tasks/{taskKey}": {
      "post": {
        "summary": "Update a task",
        "description": "This call lets you edit a specific [task](reference#read-a-task).\n\nThe post data for this request must be a well formed JSON object. The properties of the JSON object determine what properties of the task get updated. The following are the allowable properties for that JSON object. All other properties will be ignored.",
        "operationId": "update-a-task",
        "parameters": [
          {
            "name": "taskKey",
            "in": "path",
            "description": "Task key",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "text": {
                    "type": "string",
                    "description": "Updated task description"
                  },
                  "dueDate": {
                    "type": "integer",
                    "description": "Updated dueDate (in MS since epoch)",
                    "format": "int64"
                  },
                  "status": {
                    "type": "string",
                    "description": "Either `DONE` or `NOT_DONE`",
                    "default": "NOT_DONE"
                  },
                  "assignedToSharingEntries": {
                    "type": "array",
                    "description": "Each object needs a key of `email` and a value of the assignee's email.",
                    "items": {
                      "properties": {
                        "email": {
                          "type": "string",
                          "description": "Email address"
                        }
                      },
                      "type": "object"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"boxKey\": \"agxzfm1haJq3iOsIDA\",\n  \"pipelineKey\": \"agxzfm1hirZaXCgw\",\n  \"creatorKey\": \"agxzfm1hagLzluZUKDA\",\n  \"creationDate\": 1504139600683,\n  \"lastStatusChangeDate\": 1504139600683,\n  \"text\": \"Walk 500 miles\",\n  \"status\": \"DONE\",\n  \"assignedToSharingEntries\": [{\n      \"displayName\": \"Becca S\",\n      \"fullName\": \"Becca Saines\",\n      \"userKey\": \"agxzfm1CAgLzluZUKDA\"\n    }],\n  \"key\": \"agxzfmWxmPK9xZsKDA\",\n  \"lastSavedTimestamp\": 1504199083804\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "boxKey": {
                      "type": "string",
                      "example": "agxzfm1haJq3iOsIDA"
                    },
                    "pipelineKey": {
                      "type": "string",
                      "example": "agxzfm1hirZaXCgw"
                    },
                    "creatorKey": {
                      "type": "string",
                      "example": "agxzfm1hagLzluZUKDA"
                    },
                    "creationDate": {
                      "type": "integer",
                      "example": 1504139600683,
                      "default": 0
                    },
                    "lastStatusChangeDate": {
                      "type": "integer",
                      "example": 1504139600683,
                      "default": 0
                    },
                    "text": {
                      "type": "string",
                      "example": "Walk 500 miles"
                    },
                    "status": {
                      "type": "string",
                      "example": "DONE"
                    },
                    "assignedToSharingEntries": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "displayName": {
                            "type": "string",
                            "example": "Becca S"
                          },
                          "fullName": {
                            "type": "string",
                            "example": "Becca Saines"
                          },
                          "userKey": {
                            "type": "string",
                            "example": "agxzfm1CAgLzluZUKDA"
                          }
                        }
                      }
                    },
                    "key": {
                      "type": "string",
                      "example": "agxzfmWxmPK9xZsKDA"
                    },
                    "lastSavedTimestamp": {
                      "type": "integer",
                      "example": 1504199083804,
                      "default": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```