# Update Dictionary

## Updates a dictionary

> Updates the dictionary's basic metadata without content.\
> This API cannot be used for creating a new dictionary.\
> In case of update only "name" can be changed.\
> Note: All related policies will also have versions updated.<br>

```json
{"openapi":"3.0.1","info":{"title":"Agent API","version":"25.8.1"},"servers":[{"url":"youragentURL.symphony.com/agent"}],"paths":{"/v1/dlp/dictionaries/{dictId}":{"put":{"tags":["DLP Policies and Dictionary Management"],"summary":"Updates a dictionary","description":"Updates the dictionary's basic metadata without content.\nThis API cannot be used for creating a new dictionary.\nIn case of update only \"name\" can be changed.\nNote: All related policies will also have versions updated.\n","parameters":[{"name":"sessionToken","in":"header","description":"Session authentication token.","required":true,"schema":{"type":"string"}},{"name":"keyManagerToken","in":"header","description":"Key Manager authentication token.","schema":{"type":"string"}},{"name":"dictId","in":"path","description":"Unique dictionary identifier","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DLPDictionaryMetadataUpdateRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V1DLPDictionaryMetadataResponse"}}}},"400":{"description":"Client error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized: Session tokens invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden: Caller lacks necessary entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"V1DLPDictionaryMetadataUpdateRequest":{"required":["name"],"type":"object","properties":{"name":{"type":"string","description":"The name of dictionary"}},"description":"Dictionary's metadata (excluding content) to use for dictionary update operations."},"V1DLPDictionaryMetadataResponse":{"required":["data"],"type":"object","properties":{"data":{"$ref":"#/components/schemas/V1DLPDictionaryMetadata"}},"description":"Dictionary response containing dictionary metadata."},"V1DLPDictionaryMetadata":{"required":["dictRef","type"],"type":"object","properties":{"creationDate":{"type":"integer","description":"Creation time of the dictionary in milliseconds elapsed as of epoch time.","format":"int64"},"creatorId":{"type":"string","description":"Numeric userId of the creator"},"dictRef":{"$ref":"#/components/schemas/V1DLPDictionaryRef"},"lastUpdatedDate":{"type":"integer","description":"The recent update time of the dictionary in milliseconds","format":"int64"},"type":{"type":"string","description":"The type of dictionary, which specify the content is a list of words or a list of regexes.\nBy default set to \"Word\" if not specified. Possible values - Word, Regex\n"}},"description":"Dictionary's metadata (excluding content)"},"V1DLPDictionaryRef":{"required":["name"],"type":"object","properties":{"dictId":{"type":"string","description":"Unique dictionary id"},"name":{"type":"string","description":"Unique name of a dictionary, max 30 characters, with trimmed leading and trailing blank spaces."},"version":{"type":"string","description":"The version of a dictionary, in format \"major.minor\".\nInitial value will set by backend as \"1.0\" when created.\nWhenever the dictionary version needs to be changed, the minor version by 1 unless minor == 999, then the major version is increased by 1 until it reaches 999.\n"}},"description":"Basic information needed to identify a dictionary"},"Error":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}}}}
```

> #### 📘 Note
>
> * You can’t create a new dictionary with this endpoint.
> * All related policies will also have versions updated. (FIX)

> #### 🚧 Required Permissions
>
> Calling this endpoint requires a Service User Account set with the Expression Filter Policy Management role. For more information about Service User accounts and their roles, see the [Symphony Administration Guide](https://symphony.direct/).
>
> See [Bot Permissions](https://docs.developers.symphony.com/building-bots-on-symphony/configuration/bot-permissions) for a list of roles and associated privileges.