> ## Documentation Index > Fetch the complete documentation index at: https://integration.delogue.com/llms.txt > Use this file to discover all available pages before exploring further. # Updates a single color by ID. > Updates a color owned by the current organization. PUT is a full replace: every field on the request body is written to the database verbatim. The route id wins over any id present in the body. Required fields (name, state) must be present and non-null; missing or null returns 400. Nullable scalar fields (userDefinedId, userDefinedId2, colorReference, colorNote) clear the column when sent as null. Collections ('colorGroupIds', 'languageIds') are written verbatim: an explicit list replaces the association set, an empty array or an omitted/null field clears the set. Unknown colorGroupIds or languageIds are rejected per-id with field paths colorGroupIds[i] / languageIds[k]. Use PATCH for partial updates. The languageIds write is silently skipped (no error) when the organization does not have the MultipleLanguage module licensed or has not enabled UseMultipleLanguages in color settings — matches legacy behaviour. The per-(color, language) translated text is owned by a separate endpoint and is never set from this endpoint. ## OpenAPI ````yaml https://service.my.delogue.com/openapi/external.json put /api/colors/{id} openapi: 3.1.1 info: title: Delogue External API - (Production) description: Integration endpoints for Delogue API version: 1.0.0 servers: - url: >- http://ca-delogue-service-prod.bravepebble-62e34dbe.westeurope.azurecontainerapps.io/ security: [] tags: - name: SubSuppliers - name: StyleSupplierFacilities - name: StyleSkus - name: Styles - name: SampleRequests - name: StyleRelations - name: Style Prices - name: StyleItems - name: StyleFiles - name: StyleCustomFields - name: StyleContacts - name: StyleCategories - name: StyleCareInstructions - name: SizeRanges - name: Seasons - name: SampleTypes - name: Organizations - name: MeasurementCharts - name: Items - name: ItemCategories - name: Groups - name: Facilities - name: ComplianceCustomFields - name: ComplianceCategories - name: Color Groups - name: Colors - name: CareInstructions - name: CareInstructionMaterials - name: CareInstructionLayers - name: CareInstructionIcons - name: Brands - name: Barcodes paths: /api/colors/{id}: put: tags: - Colors summary: Updates a single color by ID. description: >- Updates a color owned by the current organization. PUT is a full replace: every field on the request body is written to the database verbatim. The route id wins over any id present in the body. Required fields (name, state) must be present and non-null; missing or null returns 400. Nullable scalar fields (userDefinedId, userDefinedId2, colorReference, colorNote) clear the column when sent as null. Collections ('colorGroupIds', 'languageIds') are written verbatim: an explicit list replaces the association set, an empty array or an omitted/null field clears the set. Unknown colorGroupIds or languageIds are rejected per-id with field paths colorGroupIds[i] / languageIds[k]. Use PATCH for partial updates. The languageIds write is silently skipped (no error) when the organization does not have the MultipleLanguage module licensed or has not enabled UseMultipleLanguages in color settings — matches legacy behaviour. The per-(color, language) translated text is owned by a separate endpoint and is never set from this endpoint. parameters: - name: id in: path required: true schema: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string format: int64 requestBody: content: application/json: schema: $ref: '#/components/schemas/ColorUpdateCommand' text/json: schema: $ref: '#/components/schemas/ColorUpdateCommand' application/*+json: schema: $ref: '#/components/schemas/ColorUpdateCommand' required: true responses: '200': description: OK content: text/plain: schema: $ref: '#/components/schemas/ApiResponseOfColorDto' application/json: schema: $ref: '#/components/schemas/ApiResponseOfColorDto' text/json: schema: $ref: '#/components/schemas/ApiResponseOfColorDto' '400': description: Bad Request content: text/plain: schema: $ref: '#/components/schemas/ApiErrorResponse' application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' text/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '401': description: Unauthorized content: text/plain: schema: $ref: '#/components/schemas/ApiErrorResponse' application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' text/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '403': description: Forbidden content: text/plain: schema: $ref: '#/components/schemas/ApiErrorResponse' application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' text/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '404': description: Not Found content: text/plain: schema: $ref: '#/components/schemas/ApiErrorResponse' application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' text/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '409': description: Conflict content: text/plain: schema: $ref: '#/components/schemas/ApiErrorResponse' application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' text/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '500': description: Internal Server Error content: text/plain: schema: $ref: '#/components/schemas/ApiErrorResponse' application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' text/json: schema: $ref: '#/components/schemas/ApiErrorResponse' security: - {} components: schemas: ColorUpdateCommand: type: object properties: id: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string format: int64 name: type: - 'null' - string userDefinedId: type: - 'null' - string userDefinedId2: type: - 'null' - string colorReference: type: - 'null' - string state: oneOf: - type: 'null' - $ref: '#/components/schemas/ColorState' colorNote: type: - 'null' - string colorGroupIds: type: - 'null' - array items: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string format: int64 languageIds: type: - 'null' - array items: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string format: int64 additionalProperties: false ApiResponseOfColorDto: required: - status - code - data type: object properties: status: $ref: '#/components/schemas/ApiResponseStatus' code: type: string data: oneOf: - type: 'null' - $ref: '#/components/schemas/ColorDto' additionalProperties: false ApiErrorResponse: type: object properties: status: $ref: '#/components/schemas/ApiResponseStatus' code: type: string error: $ref: '#/components/schemas/ErrorWrapper' additionalProperties: false ColorState: {} ApiResponseStatus: {} ColorDto: type: object properties: id: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string format: int64 name: type: string userDefinedId: type: - 'null' - string userDefinedId2: type: - 'null' - string colorReference: type: - 'null' - string state: $ref: '#/components/schemas/ColorState' colorNote: type: - 'null' - string colorGroups: type: array items: $ref: '#/components/schemas/ColorGroupDto' languageNames: type: array items: $ref: '#/components/schemas/ColorLanguageNameDto' properties: type: array items: type: string additionalProperties: false ErrorWrapper: type: object properties: details: type: array items: $ref: '#/components/schemas/ErrorDetailDto' additionalProperties: false ColorGroupDto: type: object properties: id: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string format: int64 name: type: string userDefinedId: type: - 'null' - string state: $ref: '#/components/schemas/ColorState' additionalProperties: false ColorLanguageNameDto: type: object properties: languageId: pattern: ^-?(?:0|[1-9]\d*)$ type: - integer - string format: int64 languageName: type: - 'null' - string languageCode: type: - 'null' - string colorName: type: - 'null' - string additionalProperties: false ErrorDetailDto: required: - type - field - value type: object properties: type: type: string field: type: - 'null' - string value: type: - 'null' - string additionalProperties: false ````