---
title: "Reject MI pilot review"
method: POST
path: "/v1/admin/formations/{id}/pilot/reject"
tags: ["Admin"]
---

# Reject MI pilot review

`POST /v1/admin/formations/{id}/pilot/reject`

## Request

- Base URL: `https://api.offshoreproz.com`
- URL: `https://api.offshoreproz.com/v1/admin/formations/{id}/pilot/reject`
- Auth: HTTP bearer

Set a formation from `action_required` to `failed` with a reason.

## Path parameters

- `id` string, required

## Request body

- object
  - `reason` string

## Response `200`

Formation failed

- object
  - `data` object
    - `formation_id` string
    - `status` string
    - `reason` string
  - `request_id` string

## Other responses

- `401`: Unauthorized — invalid or missing API key
- `404`: Not found
- `422`: Unprocessable — validation or state machine error

---

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