# Update certificate type

Updates an existing certificate type at the chain level.

All fields from creation are required. Use GET first to retrieve current values,
then modify needed fields and send complete object.

Note: Cannot update certificate types that have already been issued.

Endpoint: PUT /v1/chain/{chain_id}/loyalty/certificate_types/{type_id}
Version: 1.0.1
Security: bearer

## Header parameters:

  - `Accept` (string, required)

  - `Content-Type` (string, required)

  - `Authorization` (string, required)
    Bearer {partner_token}, User {user_token}

## Path parameters:

  - `chain_id` (integer, required)
    Chain ID
    Example: 706028

  - `type_id` (integer, required)
    Certificate type ID
    Example: 289056

## Request fields (application/json):

  - `title` (string, required)
    Certificate type name
    Example: "Gift Certificate 1500"

  - `balance` (number, required)
    Certificate face value
    Example: 1500

  - `is_multi` (boolean, required)
    true = multiple use, false = single use
    Example: true

  - `item_type_id` (integer, required)
    Usage restrictions (0-4)
    Enum: 0, 1, 2, 3, 4

  - `is_allow_empty_code` (boolean, required)
    Allow selling without code?

  - `balance_edit_type_id` (integer, required)
    Balance editability (1 = editable, 2 = not editable)
    Enum: 1, 2

  - `service_ids` (array, required)
    Specific service IDs (empty if no restriction)
    Example: []

  - `salon_ids` (array, required)
    Location IDs where certificate is valid
    Example: [720441]

  - `expiration` (object, required)
    Expiration settings

  - `expiration.type_id` (integer, required)
    Expiration type: 0 = none, 1 = fixed date, 2 = period from sale
    Enum: 0, 1, 2

  - `expiration.date` (string)
    Fixed expiration date (ISO 8601, required if type_id = 1)
    Example: "2026-12-31T23:59:59+00:00"

  - `expiration.timeout` (integer)
    Duration value (required if type_id = 2)
    Example: 6

  - `expiration.timeout_unit_id` (integer)
    Duration unit (required if type_id = 2): 1 = day, 2 = week, 3 = month, 4 = year
    Enum: 1, 2, 3, 4

  - `online_sale` (object, required)
    Online sale settings

  - `online_sale.is_enabled` (boolean, required)
    Enable online purchase?

  - `online_sale.title` (string)
    Title for online store
    Example: "Gift Certificate"

  - `online_sale.description` (string)
    Description for online store
    Example: "Perfect gift for any occasion"

  - `online_sale.price` (number)
    Online sale price
    Example: 1500

  - `category_id` (integer,null)
    Service category restriction (null = no restriction)

## Response 200 fields (application/json):

  - `success` (boolean)
    Example: true

  - `data` (object)

  - `data.id` (integer)
    Example: 289056

  - `data.title` (string)
    Example: "Gift Certificate 1500"

  - `data.balance` (number)
    Example: 1500

  - `data.is_multi` (boolean)
    Example: true

  - `data.company_group_id` (integer)
    Example: 706028

  - `data.category_id` (integer,null)

  - `data.weight` (integer)
    Example: 1

  - `data.item_type_id` (integer)

  - `data.expiration_type_id` (integer)
    Example: 2

  - `data.expiration_date` (string,null)

  - `data.expiration_timeout` (integer)
    Example: 6

  - `data.expiration_timeout_unit_id` (integer)
    Example: 3

  - `data.balance_edit_type_id` (integer)
    Example: 1

  - `data.is_allow_empty_code` (boolean)

  - `data.is_serial_number_limited` (boolean)

  - `data.is_archived` (boolean)

  - `data.date_archived` (string,null)

  - `data.online_sale_is_enabled` (boolean)

  - `data.online_sale_title` (string)
    Example: "Gift Certificate 1500"

  - `data.online_sale_description` (string)

  - `data.online_sale_price` (number)

  - `data.online_sale_image` (string,null)

  - `data.released_total` (integer)

  - `data.item_type` (object)

  - `data.service_ids` (array)
    Example: []

  - `data.salon_ids` (array)
    Example: [720441]

  - `meta` (array)
    Example: []

## Response 400 fields (application/json):

  - `success` (boolean)

  - `data` (null)

  - `meta` (object)

  - `meta.message` (string)
    Example: "An error has occurred"

  - `meta.errors` (object)

## Response 401 fields (application/json):

  - `success` (boolean)

  - `data` (null)

  - `meta` (object)

## Response 403 fields (application/json):

  - `success` (boolean)

  - `data` (null)

  - `meta` (object)

## Response 404 fields (application/json):

  - `success` (boolean)

  - `data` (null)

  - `meta` (object)