---
title: "Update a template in project"
method: PATCH
path: "/v1/projects/{projectId}/kakaotalk/senders/{plusFriendId}/templates/{templateCode}"
tags: ["KakaoTalk Templates"]
---

# Update a template in project

`PATCH /v1/projects/{projectId}/kakaotalk/senders/{plusFriendId}/templates/{templateCode}`

Updates an existing template with the request data.

## Path parameters

- `projectId` string, required
- `plusFriendId` string, required
- `templateCode` string, required

## Request body

- KakaotalkInputUpdateTemplateDto
  - `status` 'DRAFT' | 'SUBMIT' — Create as draft or submit. Defaults to draft.
  - `details` KakaotalkInputUpdateTemplateDetailsDto
    - `name` string — Button name
    - `content` string — Template body
    - `messageType` 'AD_INCLUDED' | 'BASIC' | 'EXTRA_INFORMATION' | 'MIXED' — Types of template message
    - `emphasizeType` 'EMPHASIZE_TYPE_IMAGE' | 'EMPHASIZE_TYPE_NONE' | 'EMPHASIZE_TYPE_TEXT' — Types of emphasized template
    - `categoryCode` string — Template category code
    - `securityFlag` boolean — Security template Set for security messages such as OTP If set, message text is unexposed to all devices except for the main device at the time of sending
    - `extra` string, nullable — Additional template information
    - `title` string, nullable — Template Title (No more than 50 characters, Android: To be abbreviated if it exceeds 2 lines with more than 23 characters, iOS: To be abbreviated if it exceeds 2 lines with more than 27 characters)
    - `subtitle` string, nullable — Auxiliary Template Phrase (No more than 50 characters, Android: To be abbreviated if it exceeds 18 characters, iOS: To be abbreviated if it exceeds 21 characters)
    - `imageName` string, nullable — Image name (name of uploaded file)
    - `imageUrl` string, url, nullable — Image URL - Supported mime types: `image/jpeg` or `image/png`. - Maximum file size: 500KB. - Minimum image dimensions: 500 x 250 px. - Aspect ratio: 2 x 1.
    - `buttons` KakaotalkInputButtonDto[], nullable — List of buttons Field 'type' must have unique values across items.
      - `ordering` number, required — Button sequence
      - `type` 'APP_LINK' | 'BOT_FOR_CONSULTATION' | 'BOT_KEYWORD' | 'BOT_TRANSFER' | 'BUSINESS_FORM' | 'CHANNEL_ID_ADDED' | 'DELIVERY_SEARCH' | 'IMAGE_SECURE_TRANSMISSION_PLUGIN_ID' | 'MESSAGE_DELIVERY' | 'ONE_CLICK_PAYMENT_PLUGIN' | 'PERSONAL_INFORMATION_USE_PLUGIN_ID' | 'WEB_LINK', required — Button type
      - `name` string, required — Button name Not required for draft.
      - `linkMo` string, url — Mobile web link
      - `linkPc` string, url — PC web link
      - `schemeIos` string, url — iOS app link
      - `schemeAndroid` string, url — Android app link

## Response `200`

Updated template

- KakaotalkTemplateDto
  - `id` string — The unique ID of the template.
  - `code` string, required — Registered delivery template code
  - `state` 'APPROVED' | 'REJECTED' — The current state of the template.
  - `changes` KakaotalkTemplateChangesDto
    - `status` 'DRAFT' | 'IN_PROGRESS' | 'REJECTED', required — Current status of the pending changes
    - `details` union, required — Template details and information.
      - object
        - `language` 'AF' | 'AR' | 'AZ' | 'BG' | 'BN' | 'CA' | 'CS' | 'DA' | 'DE' | 'EL' | 'EN' | 'EN_GB' | 'EN_US' | 'ES' | 'ES_AR' | 'ES_ES' | 'ES_MX' | 'ET' | 'FA' | 'FI' | 'FIL' | 'FR' | 'GA' | 'GU' | 'HA' | 'HE' | 'HI' | 'HR' | 'HU' | 'ID' | 'IT' | 'JA' | 'KA' | 'KK' | 'KN' | 'KO' | 'KY_KG' | 'LO' | 'LT' | 'LV' | 'MK' | 'ML' | 'MR' | 'MS' | 'NB' | 'NL' | 'PA' | 'PL' | 'PT_BR' | 'PT_PT' | 'RO' | 'RU' | 'RW_RW' | 'SK' | 'SL' | 'SQ' | 'SR' | 'SV' | 'SW' | 'TA' | 'TE' | 'TH' | 'TR' | 'UK' | 'UR' | 'UZ' | 'VI' | 'ZH_CN' | 'ZH_HK' | 'ZH_TW' | 'ZU' | 'UNRECOGNIZED', required — Template language
        - `messageType` 'AD_INCLUDED' | 'BASIC' | 'EXTRA_INFORMATION' | 'MIXED' | 'TEMPLATE_MESSAGE_TYPE_UNSPECIFIED' | 'UNRECOGNIZED', required — Types of template message
        - `emphasizeType` 'EMPHASIZE_TYPE_IMAGE' | 'EMPHASIZE_TYPE_NONE' | 'EMPHASIZE_TYPE_TEXT' | 'EMPHASIZE_TYPE_UNSPECIFIED' | 'UNRECOGNIZED', required — Types of emphasized template
        - `categoryCode` string, required — Template category code
        - `securityFlag` boolean, required — Security template
        - `name` string, required — Button name
        - `content` string — Template body
        - `extra` string — Additional template information
        - `ad` string — Request for consent of receiving within template or simple ad phrases
        - `title` string — Template title
        - `subtitle` string — Auxiliary template phrase
        - `imageName` string — Image name (name of uploaded file)
        - `imageUrl` string, url — Image URL
        - `buttons` KakaotalkButtonDto[], required — List of buttons
          - `ordering` number — Button sequence
          - `type` 'APP_LINK' | 'BOT_FOR_CONSULTATION' | 'BOT_KEYWORD' | 'BOT_TRANSFER' | 'BUSINESS_FORM' | 'BUTTON_TYPE_UNSPECIFIED' | 'CHANNEL_ID_ADDED' | 'DELIVERY_SEARCH' | 'IMAGE_SECURE_TRANSMISSION_PLUGIN_ID' | 'MESSAGE_DELIVERY' | 'ONE_CLICK_PAYMENT_PLUGIN' | 'PERSONAL_INFORMATION_USE_PLUGIN_ID' | 'WEB_LINK' | 'UNRECOGNIZED' — Button type
          - `name` string — Button name
          - `linkMo` string, url — Mobile web link
          - `linkPc` string, url — PC web link
          - `schemeIos` string — iOS app link
          - `schemeAndroid` string — Android app link
      - object
        - `language` 'AF' | 'AR' | 'AZ' | 'BG' | 'BN' | 'CA' | 'CS' | 'DA' | 'DE' | 'EL' | 'EN' | 'EN_GB' | 'EN_US' | 'ES' | 'ES_AR' | 'ES_ES' | 'ES_MX' | 'ET' | 'FA' | 'FI' | 'FIL' | 'FR' | 'GA' | 'GU' | 'HA' | 'HE' | 'HI' | 'HR' | 'HU' | 'ID' | 'IT' | 'JA' | 'KA' | 'KK' | 'KN' | 'KO' | 'KY_KG' | 'LO' | 'LT' | 'LV' | 'MK' | 'ML' | 'MR' | 'MS' | 'NB' | 'NL' | 'PA' | 'PL' | 'PT_BR' | 'PT_PT' | 'RO' | 'RU' | 'RW_RW' | 'SK' | 'SL' | 'SQ' | 'SR' | 'SV' | 'SW' | 'TA' | 'TE' | 'TH' | 'TR' | 'UK' | 'UR' | 'UZ' | 'VI' | 'ZH_CN' | 'ZH_HK' | 'ZH_TW' | 'ZU' | 'UNRECOGNIZED' — Template language
        - `messageType` 'AD_INCLUDED' | 'BASIC' | 'EXTRA_INFORMATION' | 'MIXED' | 'TEMPLATE_MESSAGE_TYPE_UNSPECIFIED' | 'UNRECOGNIZED' — Types of template message
        - `emphasizeType` 'EMPHASIZE_TYPE_IMAGE' | 'EMPHASIZE_TYPE_NONE' | 'EMPHASIZE_TYPE_TEXT' | 'EMPHASIZE_TYPE_UNSPECIFIED' | 'UNRECOGNIZED' — Types of emphasized template
        - `categoryCode` string — Template category code
        - `securityFlag` boolean — Security template
        - `name` string — Button name
        - `content` string — Template body
        - `extra` string — Additional template information
        - `ad` string — Request for consent of receiving within template or simple ad phrases
        - `title` string — Template title
        - `subtitle` string — Auxiliary template phrase
        - `imageName` string — Image name (name of uploaded file)
        - `imageUrl` string, url — Image URL
        - `buttons` KakaotalkButtonDto[] — List of buttons
          - `ordering` number — Button sequence
          - `type` 'APP_LINK' | 'BOT_FOR_CONSULTATION' | 'BOT_KEYWORD' | 'BOT_TRANSFER' | 'BUSINESS_FORM' | 'BUTTON_TYPE_UNSPECIFIED' | 'CHANNEL_ID_ADDED' | 'DELIVERY_SEARCH' | 'IMAGE_SECURE_TRANSMISSION_PLUGIN_ID' | 'MESSAGE_DELIVERY' | 'ONE_CLICK_PAYMENT_PLUGIN' | 'PERSONAL_INFORMATION_USE_PLUGIN_ID' | 'WEB_LINK' | 'UNRECOGNIZED' — Button type
          - `name` string — Button name
          - `linkMo` string, url — Mobile web link
          - `linkPc` string, url — PC web link
          - `schemeIos` string — iOS app link
          - `schemeAndroid` string — Android app link
  - `details` KakaotalkTemplateDetailsDto
    - `language` 'AF' | 'AR' | 'AZ' | 'BG' | 'BN' | 'CA' | 'CS' | 'DA' | 'DE' | 'EL' | 'EN' | 'EN_GB' | 'EN_US' | 'ES' | 'ES_AR' | 'ES_ES' | 'ES_MX' | 'ET' | 'FA' | 'FI' | 'FIL' | 'FR' | 'GA' | 'GU' | 'HA' | 'HE' | 'HI' | 'HR' | 'HU' | 'ID' | 'IT' | 'JA' | 'KA' | 'KK' | 'KN' | 'KO' | 'KY_KG' | 'LO' | 'LT' | 'LV' | 'MK' | 'ML' | 'MR' | 'MS' | 'NB' | 'NL' | 'PA' | 'PL' | 'PT_BR' | 'PT_PT' | 'RO' | 'RU' | 'RW_RW' | 'SK' | 'SL' | 'SQ' | 'SR' | 'SV' | 'SW' | 'TA' | 'TE' | 'TH' | 'TR' | 'UK' | 'UR' | 'UZ' | 'VI' | 'ZH_CN' | 'ZH_HK' | 'ZH_TW' | 'ZU' | 'UNRECOGNIZED', required — Template language
    - `messageType` 'AD_INCLUDED' | 'BASIC' | 'EXTRA_INFORMATION' | 'MIXED' | 'TEMPLATE_MESSAGE_TYPE_UNSPECIFIED' | 'UNRECOGNIZED', required — Types of template message
    - `emphasizeType` 'EMPHASIZE_TYPE_IMAGE' | 'EMPHASIZE_TYPE_NONE' | 'EMPHASIZE_TYPE_TEXT' | 'EMPHASIZE_TYPE_UNSPECIFIED' | 'UNRECOGNIZED', required — Types of emphasized template
    - `categoryCode` string, required — Template category code
    - `securityFlag` boolean, required — Security template
    - `name` string, required — Button name
    - `content` string — Template body
    - `extra` string — Additional template information
    - `ad` string — Request for consent of receiving within template or simple ad phrases
    - `title` string — Template title
    - `subtitle` string — Auxiliary template phrase
    - `imageName` string — Image name (name of uploaded file)
    - `imageUrl` string, url — Image URL
    - `buttons` KakaotalkButtonDto[], required — List of buttons
      - `ordering` number — Button sequence
      - `type` 'APP_LINK' | 'BOT_FOR_CONSULTATION' | 'BOT_KEYWORD' | 'BOT_TRANSFER' | 'BUSINESS_FORM' | 'BUTTON_TYPE_UNSPECIFIED' | 'CHANNEL_ID_ADDED' | 'DELIVERY_SEARCH' | 'IMAGE_SECURE_TRANSMISSION_PLUGIN_ID' | 'MESSAGE_DELIVERY' | 'ONE_CLICK_PAYMENT_PLUGIN' | 'PERSONAL_INFORMATION_USE_PLUGIN_ID' | 'WEB_LINK' | 'UNRECOGNIZED' — Button type
      - `name` string — Button name
      - `linkMo` string, url — Mobile web link
      - `linkPc` string, url — PC web link
      - `schemeIos` string — iOS app link
      - `schemeAndroid` string — Android app link
  - `created` string — The UTC Date Time in ISO 8601 for when the template was created.
  - `modified` string — The UTC Date Time in ISO 8601 for when the template was last modified.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `404` — NotFound
- `409` — Conflict
- `424` — FailedDependency
- `500` — InternalServerError

---

[API](https://skmtc.net/sinch/apis/provisioning-api.md) · [All operations](https://skmtc.net/sinch/apis/provisioning-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/provisioning-api/revisions/c78a716de420/schema)