---
title: "Skip a Task"
method: POST
path: "/tasks/{id}/skip"
tags: ["Tasks"]
---

# Skip a Task

`POST /tasks/{id}/skip`

This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

<a href="https://knowledge.apollo.io/hc/en-us/articles/28705458602125-Tasks-Overview" target="_blank">Tasks</a> let you track, prioritize, and help you complete actions required for your outbound sales motion.<br><br>Use the Skip a Task endpoint to mark an existing task as `skipped` without completing it.<br><br>To find task IDs, use the <a href="https://docs.apollo.io/reference/search-tasks">Search for Tasks endpoint</a> and identify the `id` value for the task you want to skip.<br><br>If the task no longer exists (for example, because the sequence it belonged to was paused and the task was removed), Apollo returns a `200` response with `deleted: true` on the task instead of an error.<br><br>To mark a task as done instead of skipping it, use the <a href="https://docs.apollo.io/reference/complete-a-task">Complete a Task endpoint</a>.

## Path parameters

- `id` string, required

## Request body

- object
  - `note` string — An optional note to record when skipping the task. <br><br>Example: `No longer a good fit, moving to a different sequence.`
  - `on_task_page` boolean — Whether to reindex the task synchronously so the change is immediately reflected in search results. <br><br>Defaults to `false` (indexed asynchronously).

## Response `200`

200

- object
  - `task` object
    - `id` string
    - `status` string
    - `note` unknown
    - `completed` boolean

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