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

> Mark a Gong Engage task done or dismissed, or change its due date or priority. Includes SDK V2 examples, input constraints, response fields, and Deepline cost.

Mark a Gong Engage task done or dismissed, or change its due date or priority.

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

## 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(
  'gong_update_reminder',
  {
    "taskId": 123,
    "userId": "user_123"
  },
);

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

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute gong_update_reminder --input '{
  "taskId": 123,
  "userId": "user_123"
}' --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": {
    "requestId": "request_123",
    "tasks": [
      {
        "id": 123,
        "userId": 123,
        "created": "2026-01-15T12:00:00Z"
      }
    ],
    "crmType": "SALESFORCE"
  }
}
```

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

## Input reference

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

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.taskId` | `integer` | Yes | — | Format: `int64`. |
| `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 Allowed: `OPEN`, `DONE`, `DISMISSED`. |
| `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). Format: `date-time`. |
| `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 |

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

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "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
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.requestId` | `string` | No | — | A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes. |
| `result.data.tasks` | `array` | No | — | — |
| `result.data.tasks[].id` | `integer` | No | — | The id of the task Format: `int64`. |
| `result.data.tasks[].userId` | `integer` | No | — | The id of the Gong user who owns the task Format: `int64`. |
| `result.data.tasks[].created` | `string` | No | — | 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`. |
| `result.data.tasks[].updated` | `string` | No | — | 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`. |
| `result.data.tasks[].status` | `"OPEN" \| "DONE" \| "DISMISSED"` | No | — | The task status Allowed: `OPEN`, `DONE`, `DISMISSED`. |
| `result.data.tasks[].type` | `"FLOW" \| "MANUAL"` | No | — | Describes whether the task was created as part of a flow, or is a one-off task. Allowed: `FLOW`, `MANUAL`. |
| `result.data.tasks[].actions` | `array` | No | — | Action included in the task Items must be unique. |
| `result.data.tasks[].account` | `object` | No | — | (Optional) associated crm account to task |
| `result.data.tasks[].account.crmId` | `string` | No | — | — |
| `result.data.tasks[].account.name` | `string` | No | — | — |
| `result.data.tasks[].account.crmUrl` | `string` | No | — | — |
| `result.data.tasks[].opportunity` | `object` | No | — | (Optional) associated crm deal to task |
| `result.data.tasks[].opportunity.crmId` | `string` | No | — | — |
| `result.data.tasks[].opportunity.name` | `string` | No | — | — |
| `result.data.tasks[].opportunity.crmUrl` | `string` | No | — | — |
| `result.data.tasks[].opportunity.status` | `string` | No | — | — |
| `result.data.tasks[].opportunity.stage` | `string` | No | — | — |
| `result.data.tasks[].opportunity.amount` | `string` | No | — | — |
| `result.data.tasks[].opportunity.probability` | `string` | No | — | — |
| `result.data.tasks[].opportunity.closeDate` | `string` | No | — | — |
| `result.data.tasks[].dueDate` | `string` | No | — | 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`. |
| `result.data.tasks[].flow` | `object` | No | — | (Optional) associated flow |
| `result.data.tasks[].flow.id` | `integer` | No | — | Flow id Format: `int64`. |
| `result.data.tasks[].flow.name` | `string` | No | — | Flow name |
| `result.data.tasks[].flow.step` | `object` | No | — | — |
| `result.data.tasks[].flow.step.id` | `integer` | No | — | Step id Format: `int64`. |
| `result.data.tasks[].flow.step.name` | `string` | No | — | Step name |
| `result.data.tasks[].flow.step.stepNumber` | `integer` | No | — | Step number Format: `int64`. |
| `result.data.tasks[].contact` | `object` | No | — | (Optional) Array of additional contacts for the task |
| `result.data.tasks[].contact.crmId` | `string` | No | — | The contact's CRM id |
| `result.data.tasks[].contact.type` | `"CONTACT" \| "LEAD"` | No | — | Sets whether the contact is a lead or contact in the CRM Allowed: `CONTACT`, `LEAD`. |
| `result.data.tasks[].contact.data` | `object` | No | — | — |
| `result.data.tasks[].contact.data.firstName` | `string` | No | — | The contact's first name |
| `result.data.tasks[].contact.data.lastName` | `string` | No | — | The contact's last name |
| `result.data.tasks[].contact.data.crmUrl` | `string` | No | — | A link to the contact's page in the CRM |
| `result.data.tasks[].contact.data.companyName` | `string` | No | — | The name of the company the contact works for |
| `result.data.tasks[].contact.data.affiliation` | `"Us" \| "Them" \| "Unknown"` | No | — | Contact affiliation Allowed: `Us`, `Them`, `Unknown`. |
| `result.data.tasks[].contact.data.emails` | `array` | No | — | Items must be unique. |
| `result.data.tasks[].contact.data.emails[].email` | `string` | No | — | Email addresses associated with the contact |
| `result.data.tasks[].contact.data.title` | `string` | No | — | The contact's title |
| `result.data.tasks[].contact.data.timezone` | `string` | No | — | (Optional) The timezone the contact lives in |
| `result.data.tasks[].contact.data.phoneNumbers` | `array` | No | — | Items must be unique. |
| `result.data.tasks[].contact.data.phoneNumbers[].raw` | `string` | No | — | — |
| `result.data.tasks[].contact.data.phoneNumbers[].extension` | `string` | No | — | — |
| `result.data.tasks[].contact.data.phoneNumbers[].countryCode` | `integer` | No | — | Format: `int32`. |
| `result.data.tasks[].contact.data.phoneNumbers[].normalized` | `string` | No | — | — |
| `result.data.tasks[].contact.data.phoneNumbers[].label` | `string` | No | — | — |

The table shows the first 50 fields. Expand the raw schema below for every field.

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe gong_update_reminder --json`.

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

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