> ## 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.
# Gong List Tasks: Inputs, Cost & CLI Example
> List user's tasks (/v2/tasks). Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=gong_list_tasks:{"filter":{}}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ---------------- | -------- | -------- | ------- | ------------------------ |
| `payload.filter` | `object` | Yes | | Reminder filter criteria |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Get user's tasks",
"properties": {
"filter": {
"type": "object",
"description": "Reminder filter criteria",
"properties": {
"userId": {
"type": "string",
"description": "The id of the Gong user who owns the task",
"minLength": 1
},
"workspaceId": {
"type": "string",
"description": "(Optional) The id of the workspace the tasks are in"
},
"types": {
"type": "array",
"description": "Defines whether to include tasks that were created as part of a flow, or were created as a one-off task",
"items": {
"type": "string",
"enum": [
"FLOW",
"MANUAL"
]
}
},
"taskAction": {
"type": "array",
"description": "Array of actions included in the task (valid options: CALL)",
"items": {
"type": "string",
"enum": [
"CALL"
]
}
},
"status": {
"type": "array",
"description": "Only return tasks with this status (valid options: OPEN)",
"items": {
"type": "string",
"enum": [
"OPEN",
"DONE",
"DISMISSED"
]
}
}
},
"required": [
"status",
"taskAction",
"types",
"userId"
],
"additionalProperties": false
}
},
"required": [
"filter"
],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | | Provider response payload. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Provider response payload.",
"properties": {
"requestId": {
"type": "string",
"description": "A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes."
},
"tasks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The id of the task",
"format": "int64"
},
"userId": {
"type": "integer",
"description": "The id of the Gong user who owns the task",
"format": "int64"
},
"created": {
"type": "string",
"description": "Date and time the task was created. In the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC).",
"format": "date-time"
},
"updated": {
"type": "string",
"description": "Date and time the task was last updated. In the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC).",
"format": "date-time"
},
"status": {
"type": "string",
"description": "The task status",
"enum": [
"OPEN",
"DONE",
"DISMISSED"
]
},
"type": {
"type": "string",
"description": "Describes whether the task was created as part of a flow, or is a one-off task.",
"enum": [
"FLOW",
"MANUAL"
]
},
"actions": {
"type": "array",
"description": "Action included in the task",
"uniqueItems": true,
"items": {
"type": "string",
"description": "Action included in the task",
"enum": [
"CALL"
]
}
},
"account": {
"type": "object",
"description": "(Optional) associated crm account to task",
"properties": {
"crmId": {
"type": "string"
},
"name": {
"type": "string"
},
"crmUrl": {
"type": "string"
}
},
"additionalProperties": false
},
"opportunity": {
"type": "object",
"description": "(Optional) associated crm deal to task",
"properties": {
"crmId": {
"type": "string"
},
"name": {
"type": "string"
},
"crmUrl": {
"type": "string"
},
"status": {
"type": "string"
},
"stage": {
"type": "string"
},
"amount": {
"type": "string"
},
"probability": {
"type": "string"
},
"closeDate": {
"type": "string"
}
},
"additionalProperties": false
},
"dueDate": {
"type": "string",
"description": "Date and time the task is due to be completed in the ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC).",
"format": "date-time"
},
"flow": {
"type": "object",
"description": "(Optional) associated flow",
"properties": {
"id": {
"type": "integer",
"description": "Flow id",
"format": "int64"
},
"name": {
"type": "string",
"description": "Flow name"
},
"step": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "Step id",
"format": "int64"
},
"name": {
"type": "string",
"description": "Step name"
},
"stepNumber": {
"type": "integer",
"description": "Step number",
"format": "int64"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"contact": {
"type": "object",
"description": "(Optional) Array of additional contacts for the task",
"properties": {
"crmId": {
"type": "string",
"description": "The contact's CRM id"
},
"type": {
"type": "string",
"description": "Sets whether the contact is a lead or contact in the CRM",
"enum": [
"CONTACT",
"LEAD"
]
},
"data": {
"type": "object",
"properties": {
"firstName": {
"type": "string",
"description": "The contact's first name"
},
"lastName": {
"type": "string",
"description": "The contact's last name"
},
"crmUrl": {
"type": "string",
"description": "A link to the contact's page in the CRM"
},
"companyName": {
"type": "string",
"description": "The name of the company the contact works for"
},
"affiliation": {
"type": "string",
"description": "Contact affiliation",
"enum": [
"Us",
"Them",
"Unknown"
]
},
"emails": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Email addresses associated with the contact"
}
},
"additionalProperties": false
}
},
"title": {
"type": "string",
"description": "The contact's title"
},
"timezone": {
"type": "string",
"description": "(Optional) The timezone the contact lives in"
},
"phoneNumbers": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "object",
"properties": {
"raw": {
"type": "string"
},
"extension": {
"type": "string"
},
"countryCode": {
"type": "integer",
"format": "int32"
},
"normalized": {
"type": "string"
},
"label": {
"type": "string"
},
"isVerified": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"city": {
"type": "string",
"description": "(Optional) The city the contact lives in"
},
"country": {
"type": "string",
"description": "(Optional) The country the contact lives in"
},
"state": {
"type": "string",
"description": "(Optional) The state the contact lives in"
},
"zipcode": {
"type": "string",
"description": "(Optional) The contact's zipcode"
},
"optOutChannels": {
"type": "array",
"description": "Contacts opted out channels",
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"CALLS",
"EMAILS",
"SMS"
]
}
},
"linkedinProfile": {
"type": "string",
"description": "(Optional) A link to the contact's linkedIn profile"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"additionalContacts": {
"type": "array",
"description": "(Optional) Array of additional contacts for the task",
"items": {
"type": "object",
"description": "(Optional) Array of additional contacts for the task",
"properties": {
"crmId": {
"type": "string",
"description": "The contact's CRM id"
},
"type": {
"type": "string",
"description": "Sets whether the contact is a lead or contact in the CRM",
"enum": [
"CONTACT",
"LEAD"
]
},
"data": {
"type": "object",
"properties": {
"firstName": {
"type": "string",
"description": "The contact's first name"
},
"lastName": {
"type": "string",
"description": "The contact's last name"
},
"crmUrl": {
"type": "string",
"description": "A link to the contact's page in the CRM"
},
"companyName": {
"type": "string",
"description": "The name of the company the contact works for"
},
"affiliation": {
"type": "string",
"description": "Contact affiliation",
"enum": [
"Us",
"Them",
"Unknown"
]
},
"emails": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "Email addresses associated with the contact"
}
},
"additionalProperties": false
}
},
"title": {
"type": "string",
"description": "The contact's title"
},
"timezone": {
"type": "string",
"description": "(Optional) The timezone the contact lives in"
},
"phoneNumbers": {
"type": "array",
"uniqueItems": true,
"items": {
"type": "object",
"properties": {
"raw": {
"type": "string"
},
"extension": {
"type": "string"
},
"countryCode": {
"type": "integer",
"format": "int32"
},
"normalized": {
"type": "string"
},
"label": {
"type": "string"
},
"isVerified": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"city": {
"type": "string",
"description": "(Optional) The city the contact lives in"
},
"country": {
"type": "string",
"description": "(Optional) The country the contact lives in"
},
"state": {
"type": "string",
"description": "(Optional) The state the contact lives in"
},
"zipcode": {
"type": "string",
"description": "(Optional) The contact's zipcode"
},
"optOutChannels": {
"type": "array",
"description": "Contacts opted out channels",
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"CALLS",
"EMAILS",
"SMS"
]
}
},
"linkedinProfile": {
"type": "string",
"description": "(Optional) A link to the contact's linkedIn profile"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"title": {
"type": "string",
"description": "The task title, only included if the task is of type MANUAL"
},
"priority": {
"type": "object",
"description": "The reminder priority",
"properties": {
"id": {
"type": "integer",
"description": "Priority ID",
"format": "int64"
},
"name": {
"type": "string",
"description": "Priority name"
},
"weight": {
"type": "integer",
"description": "Priority weight (higher = more important)",
"format": "int32"
}
},
"additionalProperties": false
},
"hasSpecificTime": {
"type": "boolean",
"description": "When false (default), effective due-date is 23:59 of same day"
}
},
"additionalProperties": false
}
},
"crmType": {
"type": "string",
"enum": [
"SALESFORCE",
"HUBSPOT",
"MICROSOFT_DYNAMICS",
"GENERIC"
]
}
},
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute gong_list_tasks --payload '{
"filter": {}
}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.