--- title: "Update a Task" method: PATCH path: "/tasks/{id}" tags: ["Tasks"] --- # Update a Task `PATCH /tasks/{id}` This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing). Tasks let you track, prioritize, and help you complete actions required for your outbound sales motion.

Use the Update a Task endpoint to change the details of an existing task that belongs to your team's Apollo account.

The fields you can update depend on the task's current `status`. For a task with a `scheduled` status, you can update any of the parameters listed below. For a task that's already `completed` or `skipped`, you can only update `note`, `priority`, `priority_cd`, and `contact_id`.

To find task IDs, use the Search for Tasks endpoint and identify the `id` value for the task you want to update. ## Path parameters - `id` string, required ## Request body - object - `user_id` string — The ID for the task owner within your team's Apollo account. Only applies to tasks with a `scheduled` status.

Example: `66302798d03b9601c7934ebf` - `creator_id` string — The ID of the user considered the creator of this task. Only applies to tasks with a `scheduled` status.

If this task currently has a `scheduled` status and you omit this parameter, Apollo resets it to the user associated with your API key.

Example: `60affe7d6e270a00f5db6fe4` - `contact_id` string — The Apollo ID for the contact you want on the receiving end of the action.

Example: `66e34b81740c50074e3d1bd4` - `note` string — A description for the task. This should be a human-readable message.

Example: `This contact expressed interest in the Sequences feature specifically. Be prepared to discuss.` - `type` string — Only applies to tasks with a `scheduled` status. Set the task to 1 of the following task types: - `priority` string — Assign a priority to the task: `high`, `medium`, or `low`.

If this task currently has a `scheduled` status and you omit this parameter, Apollo resets its priority to `medium`. - `priority_cd` unknown - `status` string — Only applies to tasks with a `scheduled` status. To mark a task done, use the Complete a Task or Skip a Task endpoints instead of setting this directly.

Example: `scheduled` - `due_at` string, date-time — Only applies to tasks with a `scheduled` status. The full date and time when the task is due, in ISO 8601 format.

Example: `2025-02-15T08:10:30Z` - `title` string — Only applies to tasks with a `scheduled` status. A title for the task.

Example: `Follow up on demo request` - `call_script` string — Only applies to tasks with a `scheduled` status. A call script or talking points for a `call` type task. - `relevant_fields` unknown[] — Only applies to tasks with a `scheduled` status. Names of team-defined relevant fields to surface for this task. - unknown ## Response `200` 200 - object - `task` object - `emailer_campaign_id` unknown - `id` string - `user_id` string - `created_at` string - `completed_at` unknown - `note` unknown - `skipped_at` unknown - `due_at` string - `type` string - `priority` string - `status` string - `answered` unknown - `contact_id` unknown - `person_id` unknown - `account_id` unknown - `organization_id` unknown - `persona_ids` unknown[] - unknown - `subject` unknown - `created_from` unknown - `salesforce_type` unknown - `playbook_step_ids` unknown[] - unknown - `playbook_id` unknown - `needs_playbook_autoprospecting` unknown - `starred_by_user_ids` unknown[] - unknown - `salesforce_id` unknown - `hubspot_id` unknown - `opportunity_id` string - `title` string - `rule_config_id` unknown - `creator_id` string - `completed_by_user_id` unknown - `call_script` unknown - `relevant_fields` unknown - `pending_send` boolean - `ai_variables_status` unknown - `recommended` boolean - `recommendation_reasons` unknown[] - unknown - `note_text` string — Plain-text version of `note`, with HTML tags stripped. Only present for `call` tasks. - `phone_call` object — Details about the logged phone call for this task. Only present for `call` type tasks that have an associated call log. - `id` string - `answered` boolean - `created_at` string - `phone_call_outcome_id` unknown - `phone_call_purpose_id` unknown - `to_number` string — The number that was called. May be partially masked depending on your team's phone number redaction settings. - `account` object — The account associated with this task, when the task has one. Includes the same fields as the View an Account endpoint's response, plus `linkedin_uid` and `account_queues`. - `id` string - `name` string - `website_url` string - `domain` string - `linkedin_url` string - `linkedin_uid` string - `phone` string - `phone_status` string - `owner_id` string - `account_stage_id` unknown - `organization_id` string - `industry` string - `estimated_num_employees` integer - `label_ids` unknown[] - unknown - `typed_custom_fields` object - `account_queues` unknown[] — Play/account-queue memberships for this account. - unknown - `created_at` string - `contact` object — The contact associated with this task, when the task has one. Includes the same fields as the View a Contact endpoint's response. - `id` string - `first_name` string - `last_name` string - `name` string - `email` string - `title` string - `organization_name` string - `account_id` string - `owner_id` string - `contact_stage_id` unknown - `linkedin_url` string - `phone_numbers` unknown[] - unknown - `contact_emails` unknown[] — All known email addresses for this contact, with per-address verification status. - unknown - `typed_custom_fields` object - `label_ids` unknown[] - unknown - `created_at` string - `updated_at` string - `opportunity` object - `id` string - `team_id` string - `owner_id` string - `salesforce_owner_id` unknown - `amount` integer - `closed_date` string - `account_id` string - `description` unknown - `is_closed` boolean - `is_won` unknown - `name` string - `stage_name` unknown - `opportunity_stage_id` string - `source` string - `salesforce_id` unknown - `created_at` string - `actual_close_date` unknown - `next_step` string - `next_step_date` unknown - `closed_lost_reason` unknown - `closed_won_reason` unknown - `forecast_category` string - `deal_probability` integer - `created_by_id` string - `current_solutions` unknown - `deal_source` unknown - `manually_updated_probability` unknown - `manually_updated_forecast` unknown - `crm_id` unknown - `crm_record_url` unknown - `crm_owner_id` unknown - `probability` unknown - `opportunity_pipeline_id` string - `stage_updated_at` string - `next_step_last_updated_at` string - `exchange_rate_code` string - `exchange_rate_value` integer - `amount_in_team_currency` integer - `forecasted_revenue` integer - `last_activity_date` string - `existence_level` string - `typed_custom_fields` object - `6095a711bd01d100a506d4da` string[] - `6095a711bd01d100a506d4dc` string[] - `66e4ba346fe95a073461e00e` string[] - `opportunity_rule_config_statuses` unknown[] - unknown - `opportunity_contact_roles` object[] - `id` string - `contact_id` string - `is_primary` boolean - `created_at` string - `updated_at` string - `role` object[] - `opportunity_contact_role_type_id` string - `crm_role_id` unknown - `is_primary` boolean - `crm_id` unknown - `currency` object - `name` string - `iso_code` string - `symbol` string - `account` object - `id` string - `domain` string - `name` string - `team_id` string - `organization_id` string - `account_stage_id` string - `source` string - `original_source` string - `creator_id` unknown - `owner_id` unknown - `created_at` string - `phone` unknown - `phone_status` string - `hubspot_id` unknown - `salesforce_id` unknown - `crm_owner_id` unknown - `parent_account_id` unknown - `linkedin_url` unknown - `account_playbook_statuses` unknown[] - unknown - `account_rule_config_statuses` object[] - `_id` string - `created_at` unknown - `rule_action_config_id` string - `rule_config_id` string - `status_cd` string - `updated_at` unknown - `id` string - `key` string - `existence_level` string - `label_ids` string[] - `typed_custom_fields` object - `custom_field_errors` unknown - `modality` string - `source_display_name` string - `crm_record_url` unknown - `contact_emailer_campaign_ids` unknown[] - unknown - `contact_campaign_status_tally` object - `num_contacts` integer - `last_activity_date` unknown - `relevant_field_values` object — Values for any team-defined relevant fields configured on this task's playbook step, keyed by field name. ## Other responses - `401` — 401 - `403` — 403 - `422` — 422 - `429` — 429 --- [API](https://skmtc.net/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.net/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/versions/c715a05fa6e2/schema)