> ## 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.

# List Tasks

> Retrieve action items extracted from your meetings

Returns a paginated list of action items extracted from meetings, ordered by creation date (newest first).

<Tabs>
  <Tab title="Workspace key">
    ```
    GET /v1/workspace/tasks.list
    ```

    Returns all tasks across the workspace.

    ### Parameters

    | Parameter   | Type    | Default | Description                                                     |
    | ----------- | ------- | ------- | --------------------------------------------------------------- |
    | `limit`     | number  | `50`    | Number of tasks to return (max `100`)                           |
    | `cursor`    | string  | —       | Pagination cursor from a previous response                      |
    | `startDate` | string  | —       | ISO 8601 date. Only return tasks created on or after this date  |
    | `endDate`   | string  | —       | ISO 8601 date. Only return tasks created on or before this date |
    | `userEmail` | string  | —       | Filter by a specific user's email                               |
    | `completed` | boolean | —       | Filter by completion status (`true` or `false`)                 |
    | `meetingId` | string  | —       | Filter tasks from a specific meeting                            |

    ### Example Request

    ```bash theme={null}
    curl -H "x-api-key: jk_your_workspace_key" \
      'https://beta-api.meetjamie.ai/v1/workspace/tasks.list?input={"json":{"completed":false,"limit":20}}'
    ```
  </Tab>

  <Tab title="Personal key">
    ```
    GET /v1/me/tasks.list
    ```

    Returns tasks from your own meetings and meetings shared with you.

    ### Parameters

    | Parameter   | Type    | Default | Description                                                     |
    | ----------- | ------- | ------- | --------------------------------------------------------------- |
    | `limit`     | number  | `50`    | Number of tasks to return (max `100`)                           |
    | `cursor`    | string  | —       | Pagination cursor from a previous response                      |
    | `startDate` | string  | —       | ISO 8601 date. Only return tasks created on or after this date  |
    | `endDate`   | string  | —       | ISO 8601 date. Only return tasks created on or before this date |
    | `completed` | boolean | —       | Filter by completion status (`true` or `false`)                 |
    | `meetingId` | string  | —       | Filter tasks from a specific meeting                            |

    ### Example Request

    ```bash theme={null}
    curl -H "x-api-key: jk_your_personal_key" \
      'https://beta-api.meetjamie.ai/v1/me/tasks.list?input={"json":{"completed":false,"limit":20}}'
    ```
  </Tab>
</Tabs>

## Example Response

```json theme={null}
{
  "result": {
    "data": {
      "json": {
        "tasks": [
          {
            "id": "8901234567890123456",
            "text": "Finalize technical specifications for mobile app redesign",
            "completed": false,
            "assignee": {
              "id": "person-789",
              "name": "Alex Chen",
              "email": "alex.chen@example.com"
            },
            "meetingId": "7893456789012345678",
            "meetingTitle": "Q4 Planning Meeting",
            "createdAt": "2024-11-27T15:00:00.000Z",
            "userId": "user-456"
          },
          {
            "id": "8901234567890123457",
            "text": "Schedule follow-up meeting for next week",
            "completed": true,
            "assignee": null,
            "meetingId": "7893456789012345678",
            "meetingTitle": "Q4 Planning Meeting",
            "createdAt": "2024-11-27T15:00:00.000Z",
            "userId": "user-456"
          }
        ],
        "nextCursor": "2024-11-20T10:00:00.000Z"
      }
    }
  }
}
```

## Response Fields

| Field                    | Type           | Description                                            |
| ------------------------ | -------------- | ------------------------------------------------------ |
| `tasks`                  | array          | List of task objects                                   |
| `tasks[].id`             | string         | Unique task ID                                         |
| `tasks[].text`           | string         | Task description                                       |
| `tasks[].completed`      | boolean        | Whether the task is marked as done                     |
| `tasks[].assignee`       | object \| null | Assigned person (if any)                               |
| `tasks[].assignee.id`    | string \| null | Assignee person ID                                     |
| `tasks[].assignee.name`  | string         | Assignee name                                          |
| `tasks[].assignee.email` | string \| null | Assignee email                                         |
| `tasks[].meetingId`      | string         | ID of the meeting this task was extracted from         |
| `tasks[].meetingTitle`   | string \| null | Title of the source meeting                            |
| `tasks[].createdAt`      | string         | ISO 8601 timestamp when the task was created           |
| `tasks[].userId`         | string         | ID of the user who recorded the meeting                |
| `nextCursor`             | string \| null | Cursor for the next page, or `null` if no more results |

## Common Patterns

**Get all open tasks:**

```bash theme={null}
curl -H "x-api-key: jk_your_key" \
  'https://beta-api.meetjamie.ai/v1/workspace/tasks.list?input={"json":{"completed":false}}'
```

**Get tasks from a specific meeting:**

```bash theme={null}
curl -H "x-api-key: jk_your_key" \
  'https://beta-api.meetjamie.ai/v1/workspace/tasks.list?input={"json":{"meetingId":"7893456789012345678"}}'
```

**Get tasks from the last 7 days:**

```bash theme={null}
curl -H "x-api-key: jk_your_key" \
  'https://beta-api.meetjamie.ai/v1/workspace/tasks.list?input={"json":{"startDate":"2024-11-20T00:00:00Z"}}'
```