---
updatedAt: 2026-09-09T09:34:32.000Z
agentTools:
  siteIndex: https://documentation.bloomreach.com/llms.txt
  projectIndex: https://documentation.bloomreach.com/content/llms.txt
---

# Merge a developer project

Merges a developer project.
This operation runs ansynchronously and merges the channels, content types, documents, pages and resource bundles. Merge operation pushes the changes to the core project. In case a conflict happens during the merge operation, then the operation can be tried again after resolving the conflicts manually. The result of the operation could be seen by calling the GET endpoint. 
Only users with 'Site Admin' role can run the merge operation.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Project Management API",
    "description": "The Project Management API enables developers to create, update, get, delete, rebase and merge projects.",
    "version": "1.0.0"
  },
  "externalDocs": {
    "description": "See official Bloomreach documentation",
    "url": "https://documentation.bloomreach.com/content/reference/project-management-api"
  },
  "servers": [
    {
      "url": "https://developers.bloomreach.io/management/projects/v1"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Project Operations",
      "externalDocs": {
        "description": "See",
        "url": "https://documentation.bloomreach.com/content/reference/project-operations"
      }
    }
  ],
  "paths": {
    "/{project_id}:merge": {
      "post": {
        "tags": [
          "Project Operations"
        ],
        "summary": "Merge a developer project",
        "description": "Merges a developer project.\nThis operation runs ansynchronously and merges the channels, content types, documents, pages and resource bundles. Merge operation pushes the changes to the core project. In case a conflict happens during the merge operation, then the operation can be tried again after resolving the conflicts manually. The result of the operation could be seen by calling the GET endpoint. \nOnly users with 'Site Admin' role can run the merge operation.",
        "operationId": "mergeProject",
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "description": "the identifier of the project to be merged",
            "required": true,
            "style": "simple",
            "explode": false,
            "schema": {
              "type": "string"
            },
            "example": "v0RjU"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProjectMerge"
              },
              "examples": {
                "A project": {
                  "$ref": "#/components/examples/ProjectMergeRequestExample"
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          },
          "409": {
            "description": "Conflict"
          }
        }
      }
    }
  },
  "components": {
    "examples": {
      "ProjectMergeRequestExample": {
        "value": {
          "approveAllChanges": true
        }
      }
    },
    "schemas": {
      "ProjectMerge": {
        "type": "object",
        "properties": {
          "approveAllChanges": {
            "type": "boolean",
            "description": "whether to review and approve the project automatically"
          }
        },
        "description": "Merge operation properties"
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "apiKey",
        "name": "x-auth-token",
        "in": "header"
      }
    }
  }
}
```