> ## Documentation Index > Fetch the complete documentation index at: https://docs.imprint.co/llms.txt > Use this file to discover all available pages before exploring further. # Update a card design > Activates or deactivates one of your card designs. Only `status` can be changed; any other field in the request returns `400`. Only `ACTIVE` designs can be selected by customers, so set a design to `INACTIVE` to stop offering it. With a partner-scoped API key and no `x-imprint-merchant-key` header, you can update designs configured for your partner and for any of your programs. With a merchant key, or a product-scoped API key, you can update only that program's designs. A design you cannot update returns `404`. A program's default design cannot be deactivated. **Required scope:** `CARD_DESIGN_WRITE` ## OpenAPI ````yaml /api-reference/2025-05-05/openapi.yaml patch /v2/card_designs/{card_design_id} openapi: 3.1.0 info: title: Public Imprint API version: '2.0' servers: - url: https://dev.sbx.imprint.co description: Imprint public api sandbox security: - basicAuth: [] - bearerAuth: [] paths: /v2/card_designs/{card_design_id}: patch: tags: - Card Designs summary: Update a card design description: > Activates or deactivates one of your card designs. Only `status` can be changed; any other field in the request returns `400`. Only `ACTIVE` designs can be selected by customers, so set a design to `INACTIVE` to stop offering it. With a partner-scoped API key and no `x-imprint-merchant-key` header, you can update designs configured for your partner and for any of your programs. With a merchant key, or a product-scoped API key, you can update only that program's designs. A design you cannot update returns `404`. A program's default design cannot be deactivated. **Required scope:** `CARD_DESIGN_WRITE` operationId: updateCardDesign parameters: - name: card_design_id in: path required: true description: The card design to update schema: $ref: '#/components/schemas/CardDesignID' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateCardDesignRequest' responses: '200': description: The updated card design content: application/json: schema: $ref: '#/components/schemas/CardDesign' '400': description: Invalid request, or the request would deactivate a default design content: application/json: schema: $ref: '#/components/schemas/InvalidRequestError' '403': description: API key is missing the required `CARD_DESIGN_WRITE` scope content: application/json: schema: $ref: '#/components/schemas/ApiError' '404': description: Card design not found content: application/json: schema: $ref: '#/components/schemas/CardDesignNotFoundError' components: schemas: CardDesignID: type: string description: Imprint ID for the graphic design printed on the card example: 3b9c1f3e-52a0-44c1-b131-a7ab0099a214 UpdateCardDesignRequest: type: object additionalProperties: false required: - status properties: status: type: string description: The new availability of the design. enum: - ACTIVE - INACTIVE example: INACTIVE CardDesign: type: object required: - id - name - access_min_rank - type - status properties: id: $ref: '#/components/schemas/CardDesignID' name: type: string description: Human-readable name of the card design example: Midnight Black access_min_rank: type: integer format: int64 description: > Minimum loyalty tier rank a customer must hold to select this design. `0` means available to everyone. A design with a rank above the customer's own tier is returned but cannot be selected by them. example: 0 loyalty_tier_name: type: string description: > Name of the loyalty tier corresponding to `access_min_rank`. Currently always omitted; use `access_min_rank` to determine gating. example: GOLD categories: type: object additionalProperties: type: string description: Partner-defined key/value labels for grouping designs image_orientation: $ref: '#/components/schemas/CardDesignOrientation' type: $ref: '#/components/schemas/CardDesignType' status: $ref: '#/components/schemas/CardDesignStatus' light_asset_url_path: type: string description: > Absolute URL of the card design artwork for light mode. Artwork is served from `https://assets.imprint.co` or `https://app.imprint.co` depending on where it was uploaded. example: >- https://assets.imprint.co/brand-assets/card-designs/light/midnight-black.svg dark_asset_url_path: type: string description: > Absolute URL of the card design artwork for dark mode. Artwork is served from `https://assets.imprint.co` or `https://app.imprint.co` depending on where it was uploaded. example: >- https://assets.imprint.co/brand-assets/card-designs/dark/midnight-black.svg virtual_digital_card_art_id: type: string description: Processor-side art identifier for the virtual card physical_digital_card_art_id: type: string description: Processor-side art identifier for the physical card InvalidRequestError: type: object properties: path: type: string description: The path of the endpoint returning the error example: /v2/customers details: type: array items: type: string description: The details of the error being returned example: - 'email: must be a well-formed email address' error: type: string description: The category of error being returned example: Bad Request status: type: integer description: The HTTP status code of the error example: 400 timestamp: type: string description: The timestamp that the error occurred example: '2025-01-20T18:18:22.923+00:00' ApiError: type: object required: - error properties: error: type: object required: - type - message properties: type: type: string description: The category of error being returned example: BAD_REQUEST_ERROR message: type: string description: A message describing the cause of the error example: 'unsupported reward_type: INVALID, must be STATEMENT or DELAYED' CardDesignNotFoundError: type: object required: - type - message properties: type: type: string description: The category of error being returned example: CARD_DESIGN_NOT_FOUND_ERROR message: type: string description: A message describing the cause of the error. example: card design not found CardDesignOrientation: type: string description: Orientation of the card design artwork enum: - UNSPECIFIED - VERTICAL - HORIZONTAL example: VERTICAL CardDesignType: type: string description: > Whether this is the program's default design or one of its selectable alternates. enum: - UNSPECIFIED - DEFAULT - REGULAR example: REGULAR CardDesignStatus: type: string description: | Availability of the design. Only `ACTIVE` designs can be selected. enum: - UNSPECIFIED - ACTIVE - INACTIVE - DELETED example: ACTIVE securitySchemes: basicAuth: type: http scheme: basic description: >- Basic HTTP authentication. Allowed headers-- Authorization: Basic bearerAuth: bearerFormat: auth-scheme description: >- Bearer HTTP authentication. Allowed headers-- Authorization: Bearer scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.