---
search:
  tags:
    - projects
    - POST
seo:
  description: >-
    Creates a new version (snapshot) of the current project configuration…
    Reference for the POST /projects/{id}/versions endpoint in the Leadtime
    Public API API.
sidebar:
  badge: POST
  label: Create a new project version
title: Create a new project version
type: openapi-operation
---
Creates a new version (snapshot) of the current project configuration state.

**What gets saved:**
The version captures the complete project state at the time of creation:
- Project tree structure with all components and work packages
- Products including variants, prices, and discounts
- Answered form questions and their effects
- Manually added items
- All configuration changes

**How to use:**
1. Make changes to your project configuration
2. Call this endpoint with a descriptive title
3. Optionally provide a description in HTML or Markdown format
4. The version is created and becomes the current active version

**Best practices:**
- Create versions after filling out questionnaires or making structural changes
- Create a version before sending out offers
- Use clear, descriptive version titles
- Create variants when customers want to compare alternatives

**Required permissions:** Projects.manageSnapshots permission is required to create versions.

<Operation source="api-reference" id="projectversionscontroller-createversion" />