API Version History Update

[GR_11517777]

Is there any way to update or import the Version Hystory of items through the API or otherwise?

Codebeamer 3.0.0.2

[BKampling_SAI]

Hi @GR_11517777 
Have you tried the `/v3/items/{itemId}/history` endpoint with itemId being the tracker item ID?

[anursingh]

Hi @GR_11517777,

I wanted to see if you got the help you needed.

If so, please mark the appropriate reply as the Accepted Solution. It will help other members who may have the same question.
Of course, if you have more to share on your issue, please pursue the conversation. 

Thanks,
Anurag

[pshashipreetham]

Hey,

No — Codebeamer doesn’t let you update or import version history through the API or any import tool.

Here’s the reason and your real options:

Version history in Codebeamer is system-generated. Each version is created automatically when an item is saved, updated, or changed through the UI or via an API update call. Because of this, older versions (like historical baselines or edits) can’t be recreated or injected — they’re tied to database transaction timestamps and internal revision tracking.

If you import items through the API (for example, using /tracker/items or the CSV importer), Codebeamer will treat them as new records or as new versions of existing records, but not as historical ones.

What you can do instead:

• Use the tracker item import API to create current versions and then attach any old revision data as an attachment or a rich text field (e.g., “Legacy Version History”).

• Suppose you need the true historical versions to be visible in the system. In that case, you’d have to replay updates in order, through the REST API, so each change generates a new version — but that only builds sequential history, not back-dated versions.

Thanks,