> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meetjamie.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Task

> Edit task text, mark a task as completed, or reopen it

Update a task using its `id` from [List Tasks](https://docs.meetjamie.ai/developers/api/tasks/list-tasks.md). Send `text` to edit the action item, `completed: true` to mark it done, or `completed: false` to reopen it. You can update text and completion together. Omitted fields remain unchanged, and repeating the same request is safe.

> [tab] Workspace key
>
> ```text theme={null}
> POST /v1/workspace/tasks.update
> ```
>
> Update tasks owned by current members of the key's workspace, matching workspace task listing.
>
> ```bash theme={null}
> curl -X POST -H "x-api-key: jk_your_workspace_key" \
>   -H "Content-Type: application/json" \
>   -d '{"json":{"taskId":"8901234567890123456","completed":true}}' \
>   "https://beta-api.meetjamie.ai/v1/workspace/tasks.update"
> ```

> [tab] Personal key
>
> ```text theme={null}
> POST /v1/me/tasks.update
> ```
>
> Update tasks you own. Tasks visible through shared meetings or shared tags remain read-only.
>
> ```bash theme={null}
> curl -X POST -H "x-api-key: jk_your_personal_key" \
>   -H "Content-Type: application/json" \
>   -d '{"json":{"taskId":"8901234567890123456","completed":true}}' \
>   "https://beta-api.meetjamie.ai/v1/me/tasks.update"
> ```

Existing keys work without an additional scope or a new key.

## Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `taskId` | string | Yes | Task `id` returned by `tasks.list` |
| `completed` | boolean | No | `true` to complete the task; `false` to reopen it |
| `text` | string | No | New task text, 1–10,000 characters after trimming surrounding whitespace |

Provide at least one of `completed` or `text`. Empty or whitespace-only text and unsupported fields are rejected.

## Edit Task Text

This request updates the text without changing completion status. Use `/v1/me/tasks.update` for a personal key.

```bash theme={null}
curl -X POST -H "x-api-key: jk_your_workspace_key" \
  -H "Content-Type: application/json" \
  -d '{"json":{"taskId":"8901234567890123456","text":"Send the revised proposal to the team"}}' \
  "https://beta-api.meetjamie.ai/v1/workspace/tasks.update"
```

To edit the text and reopen the task together, include both fields:

```json theme={null}
{
  "json": {
    "taskId": "8901234567890123456",
    "text": "Send the revised proposal to the team",
    "completed": false
  }
}
```

## Example Response

```json theme={null}
{
  "result": {
    "data": {
      "json": {
        "taskId": "8901234567890123456",
        "completed": true
      }
    }
  }
}
```

The response contains `taskId` and the fields you supplied. A text-only update returns `taskId` and `text`; an update of both fields returns all three. The update is reflected in Jamie and subsequent `tasks.list` responses.

## Error Responses

| Status | Cause |
| - | - |
| `400` | Missing or invalid `taskId`, invalid `completed` or `text`, no update fields, or an unsupported field |
| `403` | API key scope does not match the route |
| `404` | Task does not exist or is not writable with this key |

Missing tasks and tasks outside your write access both return `Task not found or not writable`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.