---
title: "Update a registered RCS card in place (Flow Builder V2 \"Update card\")"
description: "Creates a NEW Twilio Content Template (Content Templates are immutable — every create mints a fresh content_sid) but UPDATEs the existing rcs_content_templates ROW in place rather than inserting a new one, so a flow node's stored templateId stays stable across edits even though the underlying content_sid churns. Same validation/limits as templates/create. Authenticated workspace user (Bearer).\n"
---

> Documentation Index
> Fetch the complete documentation index at: https://developer.channelautomations.com/llms.txt
> Use this file to discover all available pages before exploring further.

Path: Channel Automation API › RCS

`PUT /api/rcs/workspaces/{workspaceId}/templates/{templateId}`

Creates a NEW Twilio Content Template (Content Templates are immutable — every create mints a fresh content_sid) but UPDATEs the existing rcs_content_templates ROW in place rather than inserting a new one, so a flow node's stored templateId stays stable across edits even though the underlying content_sid churns. Same validation/limits as templates/create. Authenticated workspace user (Bearer).

## Authentication

- `BearerAuth`, http, header `Authorization`, format `JWT`

## Path parameters

- `workspaceId` (`put/api/rcs/workspaces/workspaceId/templates/templateId.path.workspaceId`; string, required)
- `templateId` (`put/api/rcs/workspaces/workspaceId/templates/templateId.path.templateId`; string, required)

## Request body

_Required._

- `label` (`put/api/rcs/workspaces/workspaceId/templates/templateId.label`; string, required)
- `card` (`put/api/rcs/workspaces/workspaceId/templates/templateId.card`; object, required)
  - `title` (`put/api/rcs/workspaces/workspaceId/templates/templateId.card.title`; string, optional)
  - `subtitle` (`put/api/rcs/workspaces/workspaceId/templates/templateId.card.subtitle`; string, optional)
  - `body` (`put/api/rcs/workspaces/workspaceId/templates/templateId.card.body`; string, optional)
  - `media` (`put/api/rcs/workspaces/workspaceId/templates/templateId.card.media`; string, optional)
  - `buttons` (`put/api/rcs/workspaces/workspaceId/templates/templateId.card.buttons`; array<object>, optional)
    - `type` (`put/api/rcs/workspaces/workspaceId/templates/templateId.card.buttons.type`; string, optional)
      - one of `"QUICK_REPLY"`, `"URL"`, `"PHONE_NUMBER"`
    - `title` (`put/api/rcs/workspaces/workspaceId/templates/templateId.card.buttons.title`; string, optional)
    - `url` (`put/api/rcs/workspaces/workspaceId/templates/templateId.card.buttons.url`; string, optional)
    - `phone` (`put/api/rcs/workspaces/workspaceId/templates/templateId.card.buttons.phone`; string, optional)
- `description` (`put/api/rcs/workspaces/workspaceId/templates/templateId.description`; string, optional)
- `smsFallback` (`put/api/rcs/workspaces/workspaceId/templates/templateId.smsFallback`; string, optional)
- `variableMapping` (`put/api/rcs/workspaces/workspaceId/templates/templateId.variableMapping`; object, optional)

## Example request

```json
{
  "label": "string",
  "description": "string",
  "smsFallback": "string",
  "variableMapping": {},
  "card": {
    "title": "string",
    "subtitle": "string",
    "body": "string",
    "media": "string",
    "buttons": [
      {
        "type": "QUICK_REPLY",
        "title": "string",
        "url": "string",
        "phone": "string"
      }
    ]
  }
}
```

## Code samples

### cURL

```bash
curl --request PUT \
  --url 'https://api.channelautomation.com/api/rcs/workspaces/<workspaceId>/templates/<templateId>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "string",
  "description": "string",
  "smsFallback": "string",
  "variableMapping": {},
  "card": {
    "title": "string",
    "subtitle": "string",
    "body": "string",
    "media": "string",
    "buttons": [
      {
        "type": "QUICK_REPLY",
        "title": "string",
        "url": "string",
        "phone": "string"
      }
    ]
  }
}
'
```

### TypeScript

```typescript
const url = 'https://api.channelautomation.com/api/rcs/workspaces/<workspaceId>/templates/<templateId>';
const options = {
  method: 'PUT',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({
    label: 'string',
    description: 'string',
    smsFallback: 'string',
    variableMapping: {},
    card: {
      title: 'string',
      subtitle: 'string',
      body: 'string',
      media: 'string',
      buttons: [{type: 'QUICK_REPLY', title: 'string', url: 'string', phone: 'string'}]
    }
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.channelautomation.com/api/rcs/workspaces/<workspaceId>/templates/<templateId>"

payload = {
    "label": "string",
    "description": "string",
    "smsFallback": "string",
    "variableMapping": {},
    "card": {
        "title": "string",
        "subtitle": "string",
        "body": "string",
        "media": "string",
        "buttons": [
            {
                "type": "QUICK_REPLY",
                "title": "string",
                "url": "string",
                "phone": "string"
            }
        ]
    }
}
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)
```

## Responses

### 200

Card updated (same id, new contentSid) — or {ok:false, error} on validation/Twilio failure.

### 400

Missing workspaceId/templateId.

### 401

Authentication required

#### Example

```json
{
  "error": "Authentication required",
  "success": false
}
```

- `error` (`put/api/rcs/workspaces/workspaceId/templates/templateId.response.401.error`; string, optional)
  - example `"Authentication required"`
- `success` (`put/api/rcs/workspaces/workspaceId/templates/templateId.response.401.success`; boolean, optional)
  - example `false`

### 403

Membership in the path workspace is required.

### 503

Identity or workspace access verification is temporarily unavailable.


Source: https://developer.channelautomations.com/api/put-api-rcs-workspaces-workspace-id-templates-template-id/index.md