---
title: "Make one change to a group of people"
method: POST
path: "/api/v1/agent/tasks"
tags: ["Agent"]
---

# Make one change to a group of people

`POST /api/v1/agent/tasks`

## 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`
- Auth: HTTP bearer

Staged as one approval card for the whole group; approving it starts the run. 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 `202`

The run an approved card started

- object
  - `data` AgentTask, required
    - `id` integer, required
    - `operation` 'reject' | 'move' | 'shortlist' | 'restore' | 'add_tag' | 'remove_tag' | 'rescore', required
    - `status` 'queued' | 'running' | 'done' | 'failed' | 'cancelled', required
    - `total` integer, required
    - `job_post_id` integer, required
    - `finished_at` string, nullable, required
    - `done` integer, required
    - `failed` integer, required
    - `skipped` integer, required
    - `failures` object[], required
      - `name` string, required
      - `error` string, required
  - `meta` object, nullable

---

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