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

# Apollo: Search Tasks

> Search Apollo tasks, filtered by contact, assignee, type, status, or priority. Includes SDK V2 examples, input constraints, response fields, and Deepline cost.

Search Apollo tasks, filtered by contact, assignee, type, status, or priority.

> [!NOTE]
>
> Tool ID: `apollo_search_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(
  'apollo_search_tasks',
  {
    "open_factor_names": [
      "Example"
    ],
    "contact_id": "contact_123",
    "user_id": "user_123"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute apollo_search_tasks --input '{
  "open_factor_names": [
    "Example"
  ],
  "contact_id": "contact_123",
  "user_id": "user_123"
}' --json
```

## Example response

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

## Input reference

Search for tasks in Apollo. Supports filtering and pagination. Requires master API key.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.open_factor_names` | `array` | No | — | Filter by open factor names. |
| `payload.contact_id` | `string` | No | — | Filter tasks by contact ID. |
| `payload.user_id` | `string` | No | — | Filter tasks by assigned user ID. |
| `payload.type` | `string` | No | — | Filter by task type (action\_item, call, outreach\_manual\_email, linkedin\_step\_connect, linkedin\_step\_message, linkedin\_step\_view\_profile, linkedin\_step\_interact\_post). |
| `payload.status` | `string` | No | — | Filter by task status (scheduled, completed, skipped, overdue). |
| `payload.priority` | `string` | No | — | Filter by priority (no\_priority, high, medium, low). |
| `payload.page` | `integer` | No | `1` | Page number. |
| `payload.per_page` | `integer` | No | `25` | Results per page (max 100). |
| `payload.sort_by` | `string` | No | — | Field to sort results by. |
| `payload.sort_order` | `string` | No | — | Sort order: asc or desc. |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Search for tasks in Apollo. Supports filtering and pagination. Requires master API key.",
    "properties": {
      "open_factor_names": {
        "type": "array",
        "description": "Filter by open factor names.",
        "items": {
          "type": "string"
        }
      },
      "contact_id": {
        "type": "string",
        "description": "Filter tasks by contact ID."
      },
      "user_id": {
        "type": "string",
        "description": "Filter tasks by assigned user ID."
      },
      "type": {
        "type": "string",
        "description": "Filter by task type (action_item, call, outreach_manual_email, linkedin_step_connect, linkedin_step_message, linkedin_step_view_profile, linkedin_step_interact_post)."
      },
      "status": {
        "type": "string",
        "description": "Filter by task status (scheduled, completed, skipped, overdue)."
      },
      "priority": {
        "type": "string",
        "description": "Filter by priority (no_priority, high, medium, low)."
      },
      "page": {
        "type": "integer",
        "description": "Page number.",
        "default": 1
      },
      "per_page": {
        "type": "integer",
        "description": "Results per page (max 100).",
        "default": 25
      },
      "sort_by": {
        "type": "string",
        "description": "Field to sort results by."
      },
      "sort_order": {
        "type": "string",
        "description": "Sort order: asc or desc."
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Apollo search tasks result.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `record` | Yes | — | Payload with `tasks` array and `pagination` metadata. |
| `result.meta` | `record` | 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": "Apollo search tasks result.",
    "properties": {
      "data": {
        "type": [
          "object",
          "null"
        ],
        "description": "Payload with `tasks` array and `pagination` metadata.",
        "additionalProperties": {}
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": {}
      }
    },
    "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

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