---
title: "Count who a bulk change would change, and who it leaves out"
method: POST
path: "/api/v1/agent/tasks/preview"
tags: ["Agent"]
---

# Count who a bulk change would change, and who it leaves out

`POST /api/v1/agent/tasks/preview`

## Request

- Base URL: `https://api.flexiple.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.flexiple.com/api/v1/agent/tasks/preview`
- Auth: HTTP bearer

Reads only. Name exactly one target: `view_id`; `tag` with `post_id`; `saved_search_id` with `post_id`; or `application_ids`. `params`: `reason_bucket` (and optional `details`) for reject, `stage` (interview) for move, `tag` for add_tag and remove_tag; none for shortlist (Pool to the Shortlist, priced per person), restore and rescore. At most 1,000 people.

## Request body

- object
  - `operation` 'reject' | 'shortlist' | 'move' | 'restore' | 'add_tag' | 'remove_tag' | 'rescore', required
  - `target` object, required
    - `view_id` string
    - `tag` string
    - `saved_search_id` integer
    - `post_id` integer
    - `application_ids` integer[]
  - `params` object
    - `reason_bucket` string
    - `details` string, nullable
    - `stage` string
    - `tag` string

## Response `200`

What the change would do

- object
  - `data` AgentTaskPreview, required
    - `count` integer, required
    - `will_change` integer, required
    - `skipped` object[], required
      - `reason` string, required
      - `count` number, required
      - `names` string[], required
    - `credit_cost` integer, nullable, required
    - `automations` string[], required
  - `meta` object, nullable

## Other responses

- `422`: A change that cannot run as asked, with what to do instead

---

[API](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1.md) - [All operations](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/revisions/27e7987859f2?raw)