---
title: "Create a new commit for pending changes to the Cribl configuration"
method: POST
path: "/version/commit"
tags: ["versioning"]
---

# Create a new commit for pending changes to the Cribl configuration

`POST /version/commit`

Create a new commit for pending changes to the Cribl configuration. Any merge conflicts indicated in the response must be resolved using Git.</br></br>To commit only a subset of configuration changes, specify the files to include in the commit in the <code>files</code> array.

## Request body

- GitCommitBody
  - `effective` boolean
  - `files` string[]
  - `message` string, required

## Response `200`

a list of GitCommitSummary objects

- CountedGitCommitSummary
  - `count` integer — number of items present in the items array
  - `items` GitCommitSummary[]
    - `author` object
      - `email` string, required
      - `name` string, required
    - `branch` string, required
    - `commit` string, required
    - `files` FilesTypeGitCommitSummary
      - `created` string[] — Array of file paths that were created in the commit.
      - `deleted` string[] — Array of file paths that were deleted in the commit.
      - `modified` string[] — Array of file paths that were modified in the commit.
      - `renamed` GitFileRename[] — Array of file rename operations, each containing the original path and the new path.
        - `from` string, required — Original file path before the rename.
        - `to` string, required — New file path after the rename.
    - `summary` object, required
      - `changes` number, required
      - `deletions` number, required
      - `insertions` number, required

## Other responses

- `401` — Unauthorized
- `500` — Unexpected error

## Changes

- **2026-03-06** `11df16b26c1d` — 1 breaking, 2 warning, 2 info
  - the `items/items/files/renamed/items/` response's property type/format changed from `string`/`` to `object`/`` for status `200`
  - deleted the `query` request parameter `groupId`
  - removed the request property `group`
  - added the required property `items/items/files/renamed/items/from` to the response with the `200` status
  - …1 more
- **2026-01-24** `84748faee3ef` — 1 breaking
  - the response property `items/items/files` became optional for the status `200`
  - …this revision’s changelog is incomplete
- **2026-01-19** `78a6165ee901` — 1 breaking
  - the response property `items/items/files` became optional for the status `200`
  - …this revision’s changelog is incomplete
- **2025-08-26** `72f306103a82` — 1 info
  - added the new optional `query` request parameter `groupId`

[Change history](https://skmtc.dev/criblio/apis/cribl-api-reference/changes/version/commit/post.md)

---

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