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

# Pipedrive: Get Tasks

> List Pipedrive project tasks, filtered by project, assignee, done or milestone. Includes SDK V2 examples, input constraints, response fields, and Deepline cost.

List Pipedrive project tasks, filtered by project, assignee, done or milestone.

> [!NOTE]
>
> Tool ID: `pipedrive_get_tasks`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'pipedrive_get_tasks',
  {
    "cursor": "cursor_123",
    "limit": 123,
    "is_done": true
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute pipedrive_get_tasks --input '{
  "cursor": "cursor_123",
  "limit": 123,
  "is_done": true
}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "success": true,
    "data": [
      {
        "id": 123,
        "title": "VP of Engineering",
        "creator_id": 123
      }
    ],
    "additional_data": {
      "next_cursor": "cursor_123"
    }
  }
}
```

Use `deepline describe pipedrive_get_tasks --json` for the latest machine-readable contract.

## Input reference

Returns all tasks.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.cursor` | `string` | No | — | For pagination, the marker (an opaque string value) representing the first item on the next page |
| `payload.limit` | `integer` | No | — | For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Please note that a maximum value of 500 is allowed. |
| `payload.is_done` | `boolean` | No | — | Whether the task is done or not. If omitted, both done and not done tasks are returned. |
| `payload.is_milestone` | `boolean` | No | — | Whether the task is a milestone or not. If omitted, both milestone and non-milestone tasks are returned. |
| `payload.assignee_id` | `integer` | No | — | If supplied, only tasks assigned to this user are returned |
| `payload.project_id` | `integer` | No | — | If supplied, only tasks belonging to this project are returned |
| `payload.parent_task_id` | `string` | No | — | If `null` is supplied, only root-level tasks (without a parent) are returned. If an integer is supplied, only subtasks of that specific task are returned. By default all tasks are returned. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Returns all tasks.",
    "properties": {
      "cursor": {
        "type": "string",
        "description": "For pagination, the marker (an opaque string value) representing the first item on the next page"
      },
      "limit": {
        "type": "integer",
        "description": "For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Please note that a maximum value of 500 is allowed."
      },
      "is_done": {
        "type": "boolean",
        "description": "Whether the task is done or not. If omitted, both done and not done tasks are returned."
      },
      "is_milestone": {
        "type": "boolean",
        "description": "Whether the task is a milestone or not. If omitted, both milestone and non-milestone tasks are returned."
      },
      "assignee_id": {
        "type": "integer",
        "description": "If supplied, only tasks assigned to this user are returned"
      },
      "project_id": {
        "type": "integer",
        "description": "If supplied, only tasks belonging to this project are returned"
      },
      "parent_task_id": {
        "type": "string",
        "description": "If `null` is supplied, only root-level tasks (without a parent) are returned. If an integer is supplied, only subtasks of that specific task are returned. By default all tasks are returned."
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.success` | `boolean` | No | — | If the response is successful or not |
| `result.data.data` | `array` | No | — | — |
| `result.data.data[].id` | `integer` | No | — | The ID of the task |
| `result.data.data[].title` | `string` | No | — | The title of the task Minimum length: 1. Maximum length: 255. |
| `result.data.data[].creator_id` | `integer` | No | — | The ID of the user who created the task |
| `result.data.data[].description` | `string \| null` | No | — | The description of the task |
| `result.data.data[].project_id` | `integer` | No | — | The ID of the project this task is associated with |
| `result.data.data[].is_done` | `boolean` | No | — | Whether the task is done or not. |
| `result.data.data[].is_milestone` | `boolean` | No | — | Whether the task is a milestone or not. |
| `result.data.data[].due_date` | `string \| null` | No | — | The due date of the task. Format: YYYY-MM-DD. Format: `date`. |
| `result.data.data[].start_date` | `string \| null` | No | — | The start date of the task. Format: YYYY-MM-DD. Format: `date`. |
| `result.data.data[].parent_task_id` | `integer \| null` | No | — | The ID of the parent task. If `null`, the task is a root-level task. |
| `result.data.data[].assignee_ids` | `array` | No | — | The IDs of users assigned to the task |
| `result.data.data[].priority` | `integer \| null` | No | — | The priority of the task Minimum: 0. |
| `result.data.data[].add_time` | `string` | No | — | The creation date and time of the task in ISO 8601 format |
| `result.data.data[].update_time` | `string` | No | — | The update date and time of the task in ISO 8601 format |
| `result.data.data[].marked_as_done_time` | `string \| null` | No | — | The date and time the task was marked as done in ISO 8601 format |
| `result.data.additional_data` | `object` | No | — | The additional data of the list |
| `result.data.additional_data.next_cursor` | `string` | No | — | The first item on the next page. The value of the `next_cursor` field will be `null` if you have reached the end of the dataset and there’s no more pages to be returned. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Provider response payload.",
        "properties": {
          "success": {
            "type": "boolean",
            "description": "If the response is successful or not"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "integer",
                  "description": "The ID of the task"
                },
                "title": {
                  "type": "string",
                  "description": "The title of the task",
                  "minLength": 1,
                  "maxLength": 255
                },
                "creator_id": {
                  "type": "integer",
                  "description": "The ID of the user who created the task"
                },
                "description": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The description of the task"
                },
                "project_id": {
                  "type": "integer",
                  "description": "The ID of the project this task is associated with"
                },
                "is_done": {
                  "type": "boolean",
                  "description": "Whether the task is done or not."
                },
                "is_milestone": {
                  "type": "boolean",
                  "description": "Whether the task is a milestone or not."
                },
                "due_date": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The due date of the task. Format: YYYY-MM-DD.",
                  "format": "date"
                },
                "start_date": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The start date of the task. Format: YYYY-MM-DD.",
                  "format": "date"
                },
                "parent_task_id": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "description": "The ID of the parent task. If `null`, the task is a root-level task."
                },
                "assignee_ids": {
                  "type": "array",
                  "description": "The IDs of users assigned to the task",
                  "items": {
                    "type": "integer"
                  }
                },
                "priority": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "description": "The priority of the task",
                  "minimum": 0
                },
                "add_time": {
                  "type": "string",
                  "description": "The creation date and time of the task in ISO 8601 format"
                },
                "update_time": {
                  "type": "string",
                  "description": "The update date and time of the task in ISO 8601 format"
                },
                "marked_as_done_time": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "The date and time the task was marked as done in ISO 8601 format"
                }
              },
              "additionalProperties": false
            }
          },
          "additional_data": {
            "type": "object",
            "description": "The additional data of the list",
            "properties": {
              "next_cursor": {
                "type": "string",
                "description": "The first item on the next page. The value of the `next_cursor` field will be `null` if you have reached the end of the dataset and there’s no more pages to be returned."
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Pipedrive provider guide](https://deepline.com/docs/providers/pipedrive/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


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