---
title: "Move applications to a stage"
method: POST
path: "/applications/move"
tags: ["application"]
---

# Move applications to a stage

`POST /applications/move`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/applications/move`
- Auth: HTTP bearer

Moves one or more applications to Applied, Screen, Interview or Offer. Hired and Rejected are decisions (application.decide), with the person, the time and, for a rejection, the reason.

## Request body

- object
  - `application_ids` string[], required
  - `stage` 'applied' | 'screen' | 'interview' | 'offer', required: Rejected and Hired are application_decide.
  - `person_request` string: Required from an agent: the person's instruction in their own words.

## Response `200`

The result.

- object
  - `moved` object[], required
    - `id` string, required
    - `from` 'applied' | 'screen' | 'interview' | 'offer' | 'hired' | 'rejected', required
    - `to` 'applied' | 'screen' | 'interview' | 'offer' | 'hired' | 'rejected', required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)