> ## 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 Update Reminder: Inputs, Cost & CLI Example
> Update task (/v2/tasks/{taskId}). 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_update_reminder:{"taskId":"{{taskId}}","userId":"{{userId}}"}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| ------------------------- | --------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `payload.taskId` | `integer` | Yes | | |
| `payload.userId` | `string` | Yes | | The id of the Gong user who owns the task |
| `payload.status` | `"OPEN" \| "DONE" \| "DISMISSED"` | No | | (Optional) Sets a new status for the task |
| `payload.dueDate` | `string` | No | | (Optional) Sets a new due date and time for the task in ISO-8601 format ISO-8601 format (e.g., '2018-02-18T02:30:00-07:00' or '2018-02-18T08:00:00Z', where Z stands for UTC). |
| `payload.priority` | `string` | No | | (Optional) Sets a new priority for the task |
| `payload.hasSpecificTime` | `boolean` | No | | When false (default), effective due-date is 23:59 of same day |
### Allowed values
| Field | Allowed values |
| ---------------- | --------------------------- |
| `payload.status` | `OPEN`, `DONE`, `DISMISSED` |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Use this endpoint to update the status or due date of an existing Engage task. The task status can be changed to OPEN, DONE, or DISMISSED. This is useful for managing task workflows such as marking tasks complete or rescheduling them based on user actions or system events. When accessed through a Bearer token authorization method, this endpoint requires the scope 'api:tasks:write'.",
"properties": {
"taskId": {
"type": "integer",
"format": "int64"
},
"userId": {
"type": "string",
"description": "The id of the Gong user who owns the task"
},
"status": {
"type": "string",
"description": "(Optional) Sets a new status for the task",
"enum": [
"OPEN",
"DONE",
"DISMISSED"
]
},
"dueDate": {
"type": "string",
"description": "(Optional) Sets a new due date and time for the task in ISO-8601 format 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"
},
"priority": {
"type": "string",
"description": "(Optional) Sets a new priority for the task"
},
"hasSpecificTime": {
"type": "boolean",
"description": "When false (default), effective due-date is 23:59 of same day"
}
},
"required": [
"taskId",
"userId"
],
"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_update_reminder --payload '{
"taskId": "integer",
"userId": "string"
}' --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`.