---
title: "POST /api/capa/actions/{actionId}/remediation-requests/"
method: POST
path: "/api/capa/actions/{actionId}/remediation-requests/"
tags: ["CAPA"]
---

# POST /api/capa/actions/{actionId}/remediation-requests/

`POST /api/capa/actions/{actionId}/remediation-requests/`

Create a new remediation request for a CAPA action

## Path parameters

- `actionId` string, required

## Request body

- object
  - `message` string, required
  - `attachmentIds` string[]
  - `status` 'PENDING' | 'SUBMITTED' | 'CHANGES_REQUESTED' | 'APPROVED'

## Response `201`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
  - `data` object, required
    - `id` string, required
    - `actionId` string, required
    - `status` 'PENDING' | 'SUBMITTED' | 'CHANGES_REQUESTED' | 'APPROVED', required
    - `message` string, required
    - `attachmentFileIds` string[], required
    - `requestedChangeMessage` string, nullable
    - `requestedChangeDate` union
      - string
      - string, date-time
    - `requestedChangeUserId` string, nullable
    - `createdAt` union, required
      - string
      - string, date-time
    - `createdByUserId` string, required
    - `createdByCompanyId` string, required
    - `updatedAt` union, required
      - string
      - string, date-time
    - `updatedByUserId` string, nullable
    - `files` object[], required
      - `id` string, required
      - `url` string, nullable, required
      - `bucketName` string, required
      - `isPrivate` number, nullable, required
      - `name` string, nullable, required
      - `contentType` string, nullable, required
      - `fileSize` number, nullable, required
      - `createdAt` union, required
        - string
        - string, date-time
      - `previewUrl` string, nullable

## Other responses

- `400` — Default Response
- `403` — Default Response
- `404` — Default Response

## Changes

> 23 revisions in range; 1 not diffed.

- **2026-08-31** `97e51f27dc77` — 11 breaking, 13 info
  - the response property `data/files/items/contentType` became nullable for the status `201`
  - the response property `data/files/items/createdAt` became nullable for the status `201`
  - the response property `data/files/items/fileSize` became nullable for the status `201`
  - the response property `data/files/items/isPrivate` became nullable for the status `201`
  - …20 more

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/capa/actions/:actionId/remediation-requests/post.md)

---

[API](https://skmtc.dev/retraced/apis/api-reference.md) · [All operations](https://skmtc.dev/retraced/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/retraced/api-reference/revisions/fde251beb0ca/schema)