---
title: "Add a revision to an item"
method: POST
path: "/api/items/{itemId}/revision"
tags: ["Item"]
---

# Add a revision to an item

`POST /api/items/{itemId}/revision`

## Path parameters

- `itemId` string, required

## Request body

- ItemRequestAddRevision — Add an item revision.
  - `revision` string, required — The revision to be created.
  - `archiveSourceItem` boolean, nullable — Indicate whether we should archive the source item. This will default to false.

## Response `200`

Success

- CreatedResponseDto — Response for a created record
  - `id` string, required — The id of the created record

## Other responses

- `400` — Item cannot be revised
- `404` — Item did not exist
- `409` — Item revision already exists

## Changes

- **2026-09-04** `cdbcc3fdfc70` — 1 info
  - added the non-success response with the status `400`

[Change history](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/changes/api/items/:itemId/revision/post.md)

---

[API](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc.dev/fulcrumpro/apis/fulcrum-publicapi/revisions/bae242bf0067?raw)