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

# Maio 2026

> Campos adicionais em consultas por ID, idempotência em todos os endpoints POST e correções de performance.

<Update label="v1.2.1" date="2026-05-29">
  ## Melhorias de performance e correções

  **Mensagens de erro de validação:** melhorada a especificidade das mensagens de erro de validação para campos de data. Anteriormente, qualquer valor de data inválido retornava `"Invalid ISO 8601 date format."` independente do problema real. Agora a mensagem distingue entre strings malformadas, valores fora do intervalo válido e ausência de fuso horário.
</Update>

<Update label="v1.2.0" date="2026-05-26">
  ## Campos adicionais retornados em consultas por ID

  Ao buscar qualquer registro por ID (`GET /v1/people/:id`, `GET /v1/companies/:id`, `GET /v1/deals/:id`), o array `custom_fields` agora é retornado automaticamente com os valores preenchidos para aquele registro. Anteriormente, os valores de campos adicionais só estavam disponíveis via endpoint separado.

  ```json theme={null}
  {
    "data": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "full_name": "Ana Costa",
      "custom_fields": [
        {
          "id": "assoc-uuid",
          "value": "indicacao",
          "field": {
            "id": "field-uuid",
            "label": "Origem do Lead",
            "key": "origem_lead",
            "type": "select"
          }
        }
      ]
    }
  }
  ```

  Campos adicionais sem valor para o registro aparecem com `"value": null`. Os campos são retornados na ordem definida nas configurações do workspace.

  ## Header Idempotency-Key agora aceito em todos os endpoints POST

  O header `Idempotency-Key` passou a ser suportado em `POST /v1/people`, `POST /v1/companies` e `POST /v1/deals`.
</Update>

<Update label="v1.1.0" date="2026-05-05">
  ## Headers de rate limiting

  Toda resposta agora inclui os headers `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset`. Quando o limite é excedido, a API retorna `429` com header `Retry-After` indicando quando retentar.
</Update>