# Update nominal card embossing group

Update a nominal card's embossing group.<br>

As a card issuer, you can set up your own embossing configuration in the Pismo platform, which can have multiple embossing groups. Each embossing group can have its own configured schedule and embosser. Assigning a card to a different embossing group effectively changes its schedule and embosser.

Contact your Pismo representative to set up your embossing configuration and process. For more information on embossing, refer to the [Physical card embossing](doc:physical-card-embossing) guide.

**Note:** This is a PCI endpoint, use the https://gw-pci.pismolabs.io environment.


# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Card issuing - Cards",
    "version": "1.4.6",
    "description": "Card endpoints API",
    "contact": {
      "name": "API Support",
      "url": "https://developers.pismo.io/support/"
    },
    "license": {
      "name": "Copyright Pismo"
    }
  },
  "servers": [
    {
      "url": "https://sandbox.pismolabs.io",
      "description": "Sandbox API server for testing."
    },
    {
      "url": "https://gw-pci.pismolabs.io",
      "description": "Sandbox PCI API server for testing"
    }
  ],
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Embossing",
      "description": "Card embossing endpoints"
    }
  ],
  "components": {
    "parameters": {
      "cardId": {
        "in": "path",
        "name": "cardId",
        "schema": {
          "type": "string"
        },
        "description": "Pismo card ID",
        "required": true
      }
    },
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Account token - an access token encoded with a Pismo account ID. Tokens can expire quickly, which can result in an \"Unauthorized\" error.",
        "bearerFormat": "JWT"
      }
    },
    "responses": {
      "204NoContent": {
        "description": "No Content"
      }
    }
  },
  "paths": {
    "/embossing/v1/cards/{cardId}": {
      "patch": {
        "operationId": "patch-embossing-group",
        "summary": "Update nominal card embossing group",
        "description": "Update a nominal card's embossing group.<br>\n\nAs a card issuer, you can set up your own embossing configuration in the Pismo platform, which can have multiple embossing groups. Each embossing group can have its own configured schedule and embosser. Assigning a card to a different embossing group effectively changes its schedule and embosser.\n\nContact your Pismo representative to set up your embossing configuration and process. For more information on embossing, refer to the [Physical card embossing](https://developers.pismo.io/pismo-docs/docs/physical-card-embossing) guide.\n\n**Note:** This is a PCI endpoint, use the https://gw-pci.pismolabs.io environment.\n",
        "tags": [
          "Embossing"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/cardId"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "embossing_group": {
                    "type": "string",
                    "description": "Embossing group name. If not passed, the default embossing group is used."
                  }
                }
              },
              "examples": {
                "example-1": {
                  "value": {
                    "embossing_group": "key_embossing_group"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "204": {
            "$ref": "#/components/responses/204NoContent"
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "description": "",
                  "type": "object",
                  "properties": {
                    "error_code": {
                      "type": "string",
                      "description": "Error code"
                    },
                    "message": {
                      "type": "string",
                      "description": "Error message"
                    },
                    "status": {
                      "type": "integer",
                      "description": "Status"
                    },
                    "error": {
                      "type": "string",
                      "description": "Error"
                    }
                  }
                },
                "examples": {
                  "example-bad-request": {
                    "value": {
                      "message": "The field embossing_group is required",
                      "error": "bad_request",
                      "status": 400,
                      "error_code": ""
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "description": "",
                  "type": "object",
                  "properties": {
                    "error_code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example-card-not-found": {
                    "value": {
                      "message": "Card not found",
                      "error": "not_found",
                      "status": 404,
                      "error_code": ""
                    }
                  },
                  "example-config-not-found": {
                    "value": {
                      "message": "Config invalid",
                      "error": "not_found",
                      "status": 404,
                      "error_code": ""
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "Conflict",
            "content": {
              "application/json": {
                "schema": {
                  "description": "",
                  "type": "object",
                  "properties": {
                    "error_code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "error": {
                      "type": "string"
                    }
                  }
                },
                "examples": {
                  "example-conflict": {
                    "value": {
                      "message": "Card has already been embossed",
                      "error": "conflict",
                      "status": 409,
                      "error_code": ""
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
```