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

# Nooks: List Tasks

> List Nooks tasks such as calls and emails, filtered by prospect, account, sequence, owner or due date. Includes SDK V2 examples, schemas, and cost.

List Nooks tasks such as calls and emails, filtered by prospect, account, sequence, owner or due date.

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

## Run this action

This action has conditional or dynamic inputs. A static example cannot describe these inputs reliably.

Read the live contract before you execute this action:

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline describe nooks_list_tasks --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe nooks_list_tasks --json` for the complete live contract.

## Input reference

Returns a paginated list of tasks. Tasks represent individual outreach activities (calls, emails, etc.) assigned to users. Example: `bash curl -X GET 'https://partner-api.nooks.in/v1/tasks?page[size]=50' \ -H "Authorization: Bearer nooks-api-..." ` Filter by prospect: `bash curl -X GET 'https://partner-api.nooks.in/v1/tasks?filter[prospect][id]=770e8400-e29b-41d4-a716-446655440003' \ -H "Authorization: Bearer nooks-api-..." ` Filter by action type: `bash curl -X GET 'https://partner-api.nooks.in/v1/tasks?filter[action]=call,manual_email' \ -H "Authorization: Bearer nooks-api-..." ` Filter by sequence: `bash curl -X GET 'https://partner-api.nooks.in/v1/tasks?filter[sequence][id]=550e8400-e29b-41d4-a716-446655440000' \ -H "Authorization: Bearer nooks-api-..." ` Filter by account (joins through the task's prospect): \`\`\`bash curl -X GET See the live schema below for the complete notes.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.page` | `object` | No | — | Number of items per page (max 100) |
| `payload.filter` | `object` | No | — | Filter by IDs (comma-separated UUIDs). An empty value is treated as "no filter". |
| `payload.include` | `array` | No | — | Comma-separated relations to expand inline. Valid values: `owner`, `prospect`, `sequence`, `sequenceState`, `sequenceStep`. Max 3. Maximum items: 3. |

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

  ### Input JSON Schema

  ````json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Returns a paginated list of tasks. Tasks represent individual outreach activities (calls, emails, etc.) assigned to users. Example: ```bash curl -X GET 'https://partner-api.nooks.in/v1/tasks?page[size]=50' \\ -H \"Authorization: Bearer nooks-api-...\" ``` Filter by prospect: ```bash curl -X GET 'https://partner-api.nooks.in/v1/tasks?filter[prospect][id]=770e8400-e29b-41d4-a716-446655440003' \\ -H \"Authorization: Bearer nooks-api-...\" ``` Filter by action type: ```bash curl -X GET 'https://partner-api.nooks.in/v1/tasks?filter[action]=call,manual_email' \\ -H \"Authorization: Bearer nooks-api-...\" ``` Filter by sequence: ```bash curl -X GET 'https://partner-api.nooks.in/v1/tasks?filter[sequence][id]=550e8400-e29b-41d4-a716-446655440000' \\ -H \"Authorization: Bearer nooks-api-...\" ``` Filter by account (joins through the task's prospect): ```bash curl -X GET 'https://partner-api.nooks.in/v1/tasks?filter[account][id]=990e8400-e29b-41d4-a716-446655440099' \\ -H \"Authorization: Bearer nooks-api-...\" ```",
    "properties": {
      "page": {
        "type": "object",
        "description": "Number of items per page (max 100)",
        "properties": {
          "size": {
            "type": "integer",
            "description": "Number of items per page (max 100)",
            "default": 50,
            "minimum": 1,
            "maximum": 100
          },
          "after": {
            "type": "string",
            "description": "Cursor for fetching the next page. Opaque token returned by the API in `links.next`; callers should treat it as opaque and only pass values they received from a previous response. Malformed cursors return `400 Bad Request`."
          },
          "before": {
            "type": "string",
            "description": "Cursor for fetching the previous page. Opaque token returned by the API in `links.prev`; callers should treat it as opaque and only pass values they received from a previous response. Malformed cursors return `400 Bad Request`."
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "filter": {
        "type": "object",
        "description": "Filter by IDs (comma-separated UUIDs). An empty value is treated as \"no filter\".",
        "properties": {
          "id": {
            "type": "string",
            "description": "Filter by IDs (comma-separated UUIDs). An empty value is treated as \"no filter\".",
            "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}(,[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})*)?$"
          },
          "action": {
            "type": "array",
            "description": "Filter by action type (comma-separated). Valid values: call, manual_email, auto_email, manual_email_reply, auto_email_reply, basic_task, linkedin_connection_request, manual_linkedin_connection_request, manual_linkedin_message, automatic_linkedin_message, manual_sms, auto_sms",
            "items": {
              "type": "string",
              "enum": [
                "call",
                "manual_email",
                "auto_email",
                "manual_email_reply",
                "auto_email_reply",
                "basic_task",
                "linkedin_connection_request",
                "manual_linkedin_connection_request",
                "manual_linkedin_message",
                "automatic_linkedin_message",
                "manual_sms",
                "auto_sms"
              ]
            }
          },
          "status": {
            "type": "array",
            "description": "Filter by status (comma-separated). Valid values: pending, ready, finished, skipped, failed",
            "items": {
              "type": "string",
              "enum": [
                "pending",
                "ready",
                "finished",
                "skipped",
                "failed"
              ]
            }
          },
          "priority": {
            "type": "array",
            "description": "Filter by priority (comma-separated). Valid values: low, normal, high, urgent",
            "items": {
              "type": "string",
              "enum": [
                "low",
                "normal",
                "high",
                "urgent"
              ]
            }
          },
          "completed": {
            "type": "string",
            "description": "Filter by completion state. Valid values: true, false",
            "enum": [
              "true",
              "false"
            ]
          },
          "sequence": {
            "type": "object",
            "description": "Filter tasks belonging to a specific sequence",
            "properties": {
              "id": {
                "type": "string",
                "description": "Filter tasks belonging to a specific sequence",
                "format": "uuid"
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "sequenceStep": {
            "type": "object",
            "description": "Filter tasks tied to a specific sequence step",
            "properties": {
              "id": {
                "type": "string",
                "description": "Filter tasks tied to a specific sequence step",
                "format": "uuid"
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "prospect": {
            "type": "object",
            "description": "Filter tasks for a specific prospect",
            "properties": {
              "id": {
                "type": "string",
                "description": "Filter tasks for a specific prospect",
                "format": "uuid"
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "account": {
            "type": "object",
            "description": "Filter tasks associated with a specific account. Joins through the task's prospect (`Prospect.accountId`).",
            "properties": {
              "id": {
                "type": "string",
                "description": "Filter tasks associated with a specific account. Joins through the task's prospect (`Prospect.accountId`).",
                "format": "uuid"
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "owner": {
            "type": "object",
            "description": "Filter tasks assigned to a specific user",
            "properties": {
              "id": {
                "type": "string",
                "description": "Filter tasks assigned to a specific user"
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "dueAt": {
            "type": "object",
            "description": "Filter tasks due at or after this timestamp (ISO 8601)",
            "properties": {
              "gte": {
                "type": "string",
                "description": "Filter tasks due at or after this timestamp (ISO 8601)",
                "format": "date-time"
              },
              "lte": {
                "type": "string",
                "description": "Filter tasks due at or before this timestamp (ISO 8601)",
                "format": "date-time"
              }
            },
            "required": [],
            "additionalProperties": false
          },
          "sequenceState": {
            "type": "object",
            "description": "Filter by the state of the task's sequence state (comma-separated). Valid values: active, paused, finished, null. The sentinel `null` matches one-off tasks not associated with a sequence.",
            "properties": {
              "state": {
                "type": "array",
                "description": "Filter by the state of the task's sequence state (comma-separated). Valid values: active, paused, finished, null. The sentinel `null` matches one-off tasks not associated with a sequence.",
                "items": {
                  "type": "string",
                  "enum": [
                    "active",
                    "paused",
                    "finished",
                    "null"
                  ]
                }
              }
            },
            "required": [],
            "additionalProperties": false
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "include": {
        "type": "array",
        "description": "Comma-separated relations to expand inline. Valid values: `owner`, `prospect`, `sequence`, `sequenceState`, `sequenceStep`. Max 3.",
        "maxItems": 3,
        "items": {
          "type": "string",
          "enum": [
            "owner",
            "prospect",
            "sequence",
            "sequenceState",
            "sequenceStep"
          ]
        }
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ````
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.data` | `array` | No | — | — |
| `result.data.data[].id` | `string` | Yes | — | Unique identifier for the task Format: `uuid`. |
| `result.data.data[].action` | `"call" \| "manual_email" \| "auto_email" \| "manual_email_reply" \| "auto_email_reply" \| "basic_task" \| "linkedin_connection_request" \| "manual_linkedin_connection_request" \| "manual_linkedin_message" \| "automatic_linkedin_message" \| "manual_sms" \| "auto_sms"` | Yes | — | Type of action for this task: - `call`: Phone call task - `manual_email`: Manually composed email - `auto_email`: Automatically sent email - `manual_email_reply`: Manual email reply - `auto_email_reply`: Automatic email reply - `basic_task`: Generic manual task - `linkedin_connection_request`: LinkedIn connection request - `manual_linkedin_connection_request`: Manual LinkedIn connection request - `manual_linkedin_message`: Manual LinkedIn message - `automatic_linkedin_message`: Automatically See the live schema for the complete constraint. |
| `result.data.data[].completed` | `boolean` | Yes | — | Whether the task has been completed |
| `result.data.data[].dueAt` | `string` | Yes | — | When the task is due Format: `date-time`. |
| `result.data.data[].note` | `string \| null` | Yes | — | Optional note or instructions for the task |
| `result.data.data[].status` | `string \| null` | Yes | — | Current status of the task (pending, ready, finished, skipped, failed) |
| `result.data.data[].priority` | `"low" \| "normal" \| "high" \| "urgent"` | Yes | — | Priority level of the task Allowed: `low`, `normal`, `high`, `urgent`. |
| `result.data.data[].owner` | `object` | Yes | — | A reference to a related resource |
| `result.data.data[].owner.id` | `string` | Yes | — | Unique identifier of the referenced resource |
| `result.data.data[].owner._href` | `string` | Yes | — | API path to the referenced resource |
| `result.data.data[].prospect` | `object` | Yes | — | A reference to a related resource |
| `result.data.data[].prospect.id` | `string` | Yes | — | Unique identifier of the referenced resource |
| `result.data.data[].prospect._href` | `string` | Yes | — | API path to the referenced resource |
| `result.data.data[].sequence` | `object \| null` | Yes | — | A reference to a related resource |
| `result.data.data[].sequence.id` | `string` | Yes | — | Unique identifier of the referenced resource |
| `result.data.data[].sequence._href` | `string` | Yes | — | API path to the referenced resource |
| `result.data.data[].sequenceState` | `object \| null` | Yes | — | A reference to a related resource |
| `result.data.data[].sequenceState.id` | `string` | Yes | — | Unique identifier of the referenced resource |
| `result.data.data[].sequenceState._href` | `string` | Yes | — | API path to the referenced resource |
| `result.data.data[].sequenceStep` | `object \| null` | Yes | — | A reference to a related resource |
| `result.data.data[].sequenceStep.id` | `string` | Yes | — | Unique identifier of the referenced resource |
| `result.data.data[].sequenceStep._href` | `string` | Yes | — | API path to the referenced resource |
| `result.data.data[].createdAt` | `string` | Yes | — | When the task was created Format: `date-time`. |
| `result.data.data[].updatedAt` | `string` | Yes | — | When the task was last updated Format: `date-time`. |
| `result.data.links` | `object` | No | — | Pagination links for navigating through results. Links are returned as relative references (path + query) that should be resolved against the base URL of the request. |
| `result.data.links.first` | `string` | No | — | URL for the first page Format: `uri-reference`. |
| `result.data.links.prev` | `string \| null` | No | — | URL for the previous page (null if on first page) Format: `uri-reference`. |
| `result.data.links.next` | `string \| null` | No | — | URL for the next page (null if on last page) Format: `uri-reference`. |
| `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": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "A task representing an outreach activity assigned to a user",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Unique identifier for the task",
                  "format": "uuid"
                },
                "action": {
                  "type": "string",
                  "description": "Type of action for this task: - `call`: Phone call task - `manual_email`: Manually composed email - `auto_email`: Automatically sent email - `manual_email_reply`: Manual email reply - `auto_email_reply`: Automatic email reply - `basic_task`: Generic manual task - `linkedin_connection_request`: LinkedIn connection request - `manual_linkedin_connection_request`: Manual LinkedIn connection request - `manual_linkedin_message`: Manual LinkedIn message - `automatic_linkedin_message`: Automatically sent LinkedIn message - `manual_sms`: Manual SMS message - `auto_sms`: Automatically sent SMS message",
                  "enum": [
                    "call",
                    "manual_email",
                    "auto_email",
                    "manual_email_reply",
                    "auto_email_reply",
                    "basic_task",
                    "linkedin_connection_request",
                    "manual_linkedin_connection_request",
                    "manual_linkedin_message",
                    "automatic_linkedin_message",
                    "manual_sms",
                    "auto_sms"
                  ]
                },
                "completed": {
                  "type": "boolean",
                  "description": "Whether the task has been completed"
                },
                "dueAt": {
                  "type": "string",
                  "description": "When the task is due",
                  "format": "date-time"
                },
                "note": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Optional note or instructions for the task"
                },
                "status": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Current status of the task (pending, ready, finished, skipped, failed)"
                },
                "priority": {
                  "type": "string",
                  "description": "Priority level of the task",
                  "enum": [
                    "low",
                    "normal",
                    "high",
                    "urgent"
                  ]
                },
                "owner": {
                  "type": "object",
                  "description": "A reference to a related resource",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Unique identifier of the referenced resource"
                    },
                    "_href": {
                      "type": "string",
                      "description": "API path to the referenced resource"
                    }
                  },
                  "required": [
                    "id",
                    "_href"
                  ],
                  "additionalProperties": false
                },
                "prospect": {
                  "type": "object",
                  "description": "A reference to a related resource",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Unique identifier of the referenced resource"
                    },
                    "_href": {
                      "type": "string",
                      "description": "API path to the referenced resource"
                    }
                  },
                  "required": [
                    "id",
                    "_href"
                  ],
                  "additionalProperties": false
                },
                "sequence": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "description": "A reference to a related resource",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Unique identifier of the referenced resource"
                    },
                    "_href": {
                      "type": "string",
                      "description": "API path to the referenced resource"
                    }
                  },
                  "required": [
                    "id",
                    "_href"
                  ],
                  "additionalProperties": false
                },
                "sequenceState": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "description": "A reference to a related resource",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Unique identifier of the referenced resource"
                    },
                    "_href": {
                      "type": "string",
                      "description": "API path to the referenced resource"
                    }
                  },
                  "required": [
                    "id",
                    "_href"
                  ],
                  "additionalProperties": false
                },
                "sequenceStep": {
                  "type": [
                    "object",
                    "null"
                  ],
                  "description": "A reference to a related resource",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Unique identifier of the referenced resource"
                    },
                    "_href": {
                      "type": "string",
                      "description": "API path to the referenced resource"
                    }
                  },
                  "required": [
                    "id",
                    "_href"
                  ],
                  "additionalProperties": false
                },
                "createdAt": {
                  "type": "string",
                  "description": "When the task was created",
                  "format": "date-time"
                },
                "updatedAt": {
                  "type": "string",
                  "description": "When the task was last updated",
                  "format": "date-time"
                }
              },
              "required": [
                "id",
                "action",
                "completed",
                "dueAt",
                "note",
                "status",
                "priority",
                "owner",
                "prospect",
                "sequence",
                "sequenceState",
                "sequenceStep",
                "createdAt",
                "updatedAt"
              ],
              "additionalProperties": false
            }
          },
          "links": {
            "type": "object",
            "description": "Pagination links for navigating through results. Links are returned as relative references (path + query) that should be resolved against the base URL of the request.",
            "properties": {
              "first": {
                "type": "string",
                "description": "URL for the first page",
                "format": "uri-reference"
              },
              "prev": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "URL for the previous page (null if on first page)",
                "format": "uri-reference"
              },
              "next": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "URL for the next page (null if on last page)",
                "format": "uri-reference"
              }
            },
            "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

* [Nooks provider guide](https://deepline.com/docs/providers/nooks/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.