> ## Documentation Index
> Fetch the complete documentation index at: https://docs.breakcold.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API changelog

> Breaking changes, new capabilities, and migration guidance for the Breakcold REST API and MCP.

Follow this page for production-affecting changes to the Breakcold REST API and MCP. Product updates remain available from [**What's New** inside Breakcold](https://app.breakcold.com), and related product posts link back here when developer action is relevant.

Use the RSS button at the top of this page to subscribe, or add `https://docs.breakcold.com/api/changelog/rss.xml` to your RSS reader.

<Update
  label="July 14, 2026"
  description="Record creation validation"
  tags={["Breaking", "REST", "MCP"]}
  rss={{
title: "Record creation now requires complete initial fields",
description: "Record creation rejects empty payloads and enforces required fields.",
}}
>
  ## Record creation now requires complete initial fields

  Record creation now rejects empty field payloads and enforces fields configured as required for the target object.

  ### Action required

  * REST `POST /records` requires a non-empty `fields` object.
  * Include every required field unless it has a configured default.
  * REST retries may use the optional `Idempotency-Key` header.
  * MCP `records_create` requires a stable `idempotencyKey` tool argument.

  ### Migration

  1. List fields with `GET /crm/objects/{objectTypeId}/fields`.
  2. Include values for required fields without defaults.
  3. Reuse the same idempotency value when retrying the same logical request.

  See [Create a record](/api-reference/records/create-a-record) and [List CRM fields](/api-reference/crm/list-crm-fields).
</Update>