---
title: "Changes to Create or update Dictionaries from Dictionaries Spec"
method: PUT
path: "/organizations/{orgId}/environments/{envId}/dictionaries"
---

# Changes to Create or update Dictionaries from Dictionaries Spec

`PUT /organizations/{orgId}/environments/{envId}/dictionaries`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 14 revisions.

- **2026-11-03** `460368511dae`: 3 breaking, 1 warning, 6 info
- **2026-10-07** `ecefec7d65f9`: 3 breaking, 5 warning, 2 info
- **2026-10-07** `38309c3af78d`: 2 info
- **2026-10-07** `eb875d036ac9`: 3 breaking, 1 warning, 4 info

## Changes

- **2026-11-03** `460368511dae`: 3 breaking, 1 warning, 6 info
  - the `manual` request property type changed from no type to `object`
  - the response property `allOf[#/components/schemas/DictionarySpec]/manual/properties` became optional for the status `200`
  - the `allOf[#/components/schemas/DictionarySpec]/manual` response's property type changed from no type to `object` for status `200`
  - changed the pattern of the request property `hrid` from `^[a-zA-Z0-9][a-zA-Z0-9_-]+[a-zA-Z0-9]$` to `^[a-zA-Z0-9][a-zA-Z0-9_.-]+[a-zA-Z0-9]$`
  - added the new optional request property `dynamic/encryption`
  - added the new optional request property `manual/encryptedProperties`
  - the request property `manual/properties` became optional
  - added the optional property `allOf[#/components/schemas/DictionarySpec]/dynamic/encryption` to the response with the `200` status
  - added the optional property `allOf[#/components/schemas/DictionarySpec]/manual/encryptedProperties` to the response with the `200` status
  - the `allOf[#/components/schemas/DictionarySpec]/hrid` response's property pattern was changed from `^[a-zA-Z0-9][a-zA-Z0-9_-]+[a-zA-Z0-9]$` to `^[a-zA-Z0-9][a-zA-Z0-9_.-]+[a-zA-Z0-9]$` for the status `200`
- **2026-10-07** `ecefec7d65f9`: 3 breaking, 5 warning, 2 info
  - the request property `manual/properties` became required
  - the `manual` request property type changed from `object` to no type
  - the `allOf[#/components/schemas/DictionarySpec]/manual` response's property type changed from `object` to no type for status `200`
  - changed the pattern of the request property `hrid` from `^[a-zA-Z0-9][a-zA-Z0-9_.-]+[a-zA-Z0-9]$` to `^[a-zA-Z0-9][a-zA-Z0-9_-]+[a-zA-Z0-9]$`
  - removed the request property `dynamic/encryption`
  - removed the request property `manual/encryptedProperties`
  - removed the optional property `allOf[#/components/schemas/DictionarySpec]/dynamic/encryption` from the response with the `200` status
  - removed the optional property `allOf[#/components/schemas/DictionarySpec]/manual/encryptedProperties` from the response with the `200` status
  - the response property `allOf[#/components/schemas/DictionarySpec]/manual/properties` became required for the status `200`
  - the `allOf[#/components/schemas/DictionarySpec]/hrid` response's property pattern was changed from `^[a-zA-Z0-9][a-zA-Z0-9_.-]+[a-zA-Z0-9]$` to `^[a-zA-Z0-9][a-zA-Z0-9_-]+[a-zA-Z0-9]$` for the status `200`
- **2026-10-07** `38309c3af78d`: 2 info
  - added the new optional request property `dynamic/encryption`
  - added the optional property `allOf[#/components/schemas/DictionarySpec]/dynamic/encryption` to the response with the `200` status
- **2026-10-07** `eb875d036ac9`: 3 breaking, 1 warning, 4 info
  - the `manual` request property type changed from no type to `object`
  - the response property `allOf[#/components/schemas/DictionarySpec]/manual/properties` became optional for the status `200`
  - the `allOf[#/components/schemas/DictionarySpec]/manual` response's property type changed from no type to `object` for status `200`
  - changed the pattern of the request property `hrid` from `^[a-zA-Z0-9][a-zA-Z0-9_-]+[a-zA-Z0-9]$` to `^[a-zA-Z0-9][a-zA-Z0-9_.-]+[a-zA-Z0-9]$`
  - added the new optional request property `manual/encryptedProperties`
  - the request property `manual/properties` became optional
  - added the optional property `allOf[#/components/schemas/DictionarySpec]/manual/encryptedProperties` to the response with the `200` status
  - the `allOf[#/components/schemas/DictionarySpec]/hrid` response's property pattern was changed from `^[a-zA-Z0-9][a-zA-Z0-9_-]+[a-zA-Z0-9]$` to `^[a-zA-Z0-9][a-zA-Z0-9_.-]+[a-zA-Z0-9]$` for the status `200`

---

[Operation](https://skmtc.dev/gravitee-io/apis/gravitee-io-automation-api/docs/organizations/:orgId/environments/:envId/dictionaries/put.md) - [API](https://skmtc.dev/gravitee-io/apis/gravitee-io-automation-api.md) - [Page](https://skmtc.dev/gravitee-io/apis/gravitee-io-automation-api/changes/organizations/:orgId/environments/:envId/dictionaries/put)