---
title: "Update an RCS template"
method: PUT
path: "/rcs/template/{template_id}"
tags: ["RCS Templates"]
---

# Update an RCS template

`PUT /rcs/template/{template_id}`

## Request

- Base URL: `https://rcs-api.in.kaleyra.io/v1/XXXXX6913850XXXX`
- URL: `https://rcs-api.in.kaleyra.io/v1/XXXXX6913850XXXX/rcs/template/{template_id}`
- Auth: none declared. Required headers: `Content-Type`, `api-key`

## Path parameters

- `template_id` string, required

## Headers

- `Content-Type` 'application/json', required
- `api-key` string, required

## Request body

- UpdateTemplateRequest
  - `template_id` string, required: Unique template ID. Required but cannot be modified.
  - `agent_number` string, required: RCS agent number.
  - `template_type` '1' | '3' | '4' | '5', required: Template type. 1 is Text, 3 is File, 4 is Rich Card Standalone, and 5 is Rich Card Carousel.
  - `template_name` string, required: Unique template name. Maximum 20 characters including alphanumeric characters and underscore. Space is not allowed.
  - `text` string: Text message to send to end users. Maximum 2000 characters. Conditional when template_type is 1.
  - `status` 'DRAFT' | 'CREATED' | 'SUBMITTEDFORAPPROVAL' | 'ACTIVE' | 'FAILED' | 'DELETED', required: Template status. DRAFT can be edited. CREATED can be edited until ACTIVE. SUBMITTEDFORAPPROVAL indicates submission to the carrier. ACTIVE templates can be used for messaging and cannot be edited. FAILED and DELETED are documented workflow states.
  - `template_number` string, required: Template reference number. Restricted field and cannot be modified.

## Response `200`

RCS Template updated successfully.

- UpdateTemplateResponse
  - `code` string
  - `message` string
  - `data` UpdateTemplateData
    - `template_id` string: Template ID.
    - `created_date` string: Creation date/time of the template.
    - `agent_number` string: Agent number.
    - `template_type` '1' | '3' | '4' | '5': Template type. 1 is Text, 3 is File, 4 is Rich Card Standalone, and 5 is Rich Card Carousel.
    - `template_name` string: Unique template name.
    - `text` string: Template text.
    - `status` 'DRAFT' | 'CREATED' | 'SUBMITTEDFORAPPROVAL' | 'ACTIVE' | 'FAILED' | 'DELETED': Template status. DRAFT can be edited. CREATED can be edited until ACTIVE. SUBMITTEDFORAPPROVAL indicates submission to the carrier. ACTIVE templates can be used for messaging and cannot be edited. FAILED and DELETED are documented workflow states.
    - `template_number` string: Template reference number.
  - `error` object

## Other responses

- `400`: Bad request.
- `405`: Method not allowed.
- `500`: Internal Gateway Error.

---

[API](https://skmtc.dev/kaleyra/apis/kaleyra-rcs-template-api.md) - [All operations](https://skmtc.dev/kaleyra/apis/kaleyra-rcs-template-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kaleyra/apis/kaleyra-rcs-template-api/revisions/996348f423f0?raw)