> ## 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. # Rename a barcode (full replace) > Renames a barcode owned by the caller's organization. PUT is a full replace: barcode is the only writable field, so the body carries the complete writable surface. barcode is required and must be unique within the organization (409 if taken). Renaming is only allowed while the barcode is still unassigned: one already linked to a SKU or a style assortment returns 409 - unlink it from the style first, or create a new barcode instead. Renaming to the value the barcode already has is a no-op and returns 200. linkedToSku and linkedToStyleAssortment are maintained by the system and are rejected if supplied. The route id wins; the body carries no id. A barcode that exists in no organization returns 404, one belonging to a different organization returns 403. ## OpenAPI ````yaml https://service.my.delogue.com/openapi/external.json put /api/barcodes/{id} openapi: 3.1.1 info: title: Delogue External API - (Production) description: Integration endpoints for Delogue API version: 1.0.0 servers: - url: / description: The Delogue environment serving this document. - url: https://{host} description: Per-customer Delogue API host. variables: host: default: service.my.delogue.com description: >- The API host for your Delogue environment, e.g. service..delogue.com. security: [] tags: - name: Barcodes - name: Brands - name: CareInstructionIcons - name: CareInstructionLayers - name: CareInstructionMaterials - name: CareInstructions - name: Color Groups - name: Colors - name: ComplianceCategories - name: ComplianceCustomFields - name: Facilities - name: Groups - name: ItemCategories - name: Items - name: MeasurementCharts - name: MigrationApproval - name: MigrationVerification - name: OrganizationMigration - name: Organizations - name: SampleRequests - name: SampleTypes - name: Seasons - name: SizeRanges - name: Style Prices - name: StyleCareInstructions - name: StyleCategories - name: StyleColors - name: StyleContacts - name: StyleCustomFields - name: StyleFiles - name: StyleItems - name: StyleRelations - name: Styles - name: StyleSkus - name: StyleSupplierFacilities - name: SubSuppliers - name: Suppliers paths: /api/barcodes/{id}: put: tags: - Barcodes summary: Rename a barcode (full replace) description: >- Renames a barcode owned by the caller's organization. PUT is a full replace: barcode is the only writable field, so the body carries the complete writable surface. barcode is required and must be unique within the organization (409 if taken). Renaming is only allowed while the barcode is still unassigned: one already linked to a SKU or a style assortment returns 409 - unlink it from the style first, or create a new barcode instead. Renaming to the value the barcode already has is a no-op and returns 200. linkedToSku and linkedToStyleAssortment are maintained by the system and are rejected if supplied. The route id wins; the body carries no id. A barcode that exists in no organization returns 404, one belonging to a different organization returns 403. operationId: Barcodes_Update parameters: - name: id in: path required: true schema: type: integer format: int64 requestBody: content: application/json: schema: $ref: '#/components/schemas/BarcodeUpdateDto' application/*+json: schema: $ref: '#/components/schemas/BarcodeUpdateDto' required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ApiResponseOfBarcodeDto' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '401': description: Unauthorized content: application/problem+json: schema: $ref: '#/components/schemas/ApiErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/ApiErrorResponse' '500': description: Internal Server Error content: application/problem+json: schema: $ref: '#/components/schemas/ApiErrorResponse' security: - {} components: schemas: BarcodeUpdateDto: type: object properties: barcode: type: - 'null' - string description: >- The new barcode value, such as a 13-digit EAN number. Required, and unique within the organization. additionalProperties: false ApiResponseOfBarcodeDto: required: - status - code - data type: object properties: status: $ref: '#/components/schemas/ApiResponseStatus' description: >- The coarse outcome of the request, indicating whether it succeeded or failed. code: type: string description: >- The specific machine-readable outcome code, such as ok on success or the most specific error code on failure. Always lowercase on the wire. data: oneOf: - type: 'null' - $ref: '#/components/schemas/BarcodeDto' description: >- The response payload, either a single object for a by-id read or an array for a bulk operation. Omitted from the body when there is no value. description: >- The response payload, either a single object for a by-id read or an array for a bulk operation. Omitted from the body when there is no value. additionalProperties: false ApiErrorResponse: type: object properties: status: $ref: '#/components/schemas/ApiResponseStatus' description: >- The coarse outcome of the request, indicating whether it succeeded or failed. code: type: string description: >- The specific machine-readable outcome code, such as ok on success or the most specific error code on failure. Always lowercase on the wire. error: $ref: '#/components/schemas/ErrorWrapper' description: >- The error payload, present instead of data on a failed response. It wraps the list of detail rows describing what went wrong. additionalProperties: false ApiResponseStatus: enum: - success - error type: string description: >- The coarse outcome of the request, indicating whether it succeeded or failed. BarcodeDto: type: object properties: id: type: integer description: Unique identifier of the barcode. format: int64 barcode: type: string description: >- The barcode value assigned to the SKU, such as a 13-digit EAN number. properties: type: array items: type: string description: >- Linkage flags for the barcode. Includes linkedToSku when it is linked to a SKU and linkedToStyleAssortment when it is linked to a style assortment. additionalProperties: false description: >- The response payload, either a single object for a by-id read or an array for a bulk operation. Omitted from the body when there is no value. ErrorWrapper: type: object properties: details: type: array items: $ref: '#/components/schemas/ErrorDetailDto' description: >- The list of individual error detail rows for this failure, one per field or rule that failed. additionalProperties: false description: >- The error payload, present instead of data on a failed response. It wraps the list of detail rows describing what went wrong. ErrorDetailDto: required: - type - field - value type: object properties: type: type: string description: >- The hierarchical error code identifying the specific failure, such as validation_error.required_field. Consumers branch on this rather than on the message text. field: type: - 'null' - string description: >- The input field that caused the failure. Omitted when no specific field is at fault, such as an authorization denial or a server error. value: type: - 'null' - string description: >- A human-readable message describing the failure, or the offending value or limit that triggered it. additionalProperties: false ````