Skip to main content
PATCH
/
v1
/
communications
/
templates
/
{id}
Updates a communications template
curl --request PATCH \
  --url https://api.rootly.com/v1/communications/templates/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '{
  "data": {
    "type": "communications-templates",
    "attributes": {
      "name": "<string>",
      "description": "<string>",
      "communication_type_id": "<string>",
      "position": 123,
      "communication_template_stages_attributes": [
        {
          "id": "<string>",
          "sms_content": "<string>",
          "email_subject": "<string>",
          "email_body": "<string>",
          "slack_content": "<string>"
        }
      ]
    }
  }
}'
{
  "data": {
    "id": "1e233eb9-5d0b-40e8-9e35-72642a9ccc65",
    "type": "communications-templates",
    "attributes": {
      "name": "Updated Template Name",
      "slug": "uwbgr",
      "description": "Updated description",
      "position": 1,
      "created_at": "2025-11-27T00:06:49.568-08:00",
      "updated_at": "2025-11-27T00:06:52.182-08:00",
      "communication_type_id": "613e5834-8cf3-431e-a1fd-e95f8cd60036",
      "communication_type": {
        "data": {
          "id": "613e5834-8cf3-431e-a1fd-e95f8cd60036",
          "type": "communications_types",
          "attributes": {
            "name": "wd4y7",
            "slug": "wd4y7",
            "description": "Incidunt sunt ea quo.",
            "color": "#F4CFD1",
            "position": 1,
            "created_at": "2025-11-27T00:06:49.553-08:00",
            "updated_at": "2025-11-27T00:06:49.553-08:00",
            "communication_groups": [],
            "communication_templates": [
              {
                "id": "1e233eb9-5d0b-40e8-9e35-72642a9ccc65",
                "name": "Updated Template Name"
              },
              {
                "id": "523cfc7b-bcd6-435a-bafb-450c3e6a9dc8",
                "name": "aov1u"
              },
              {
                "id": "81bf935d-5f5b-4381-abac-bab613d8c4a9",
                "name": "ki76q"
              },
              {
                "id": "77e556cc-4cdc-415c-a2bb-28c6f47b2367",
                "name": "9lw41"
              },
              {
                "id": "00461271-29b9-4528-8588-e0d3dd73216f",
                "name": "tuwdg"
              },
              {
                "id": "20ad918b-76a0-4bcb-8b0c-779e86a915ac",
                "name": "d0nkg"
              },
              {
                "id": "008c542f-0952-4807-a619-ef9061d346ef",
                "name": "udyvj"
              },
              {
                "id": "266b41ad-564f-4699-91e3-93a84916be0b",
                "name": "ngp7z"
              },
              {
                "id": "72440d82-d4ed-4c7c-a0e1-e070b1f29488",
                "name": "hoqjg"
              },
              {
                "id": "7d746dbc-5f43-4318-b5a7-b18c35d07470",
                "name": "zv1uz"
              }
            ]
          }
        }
      },
      "communication_template_stages": [
        {
          "data": {
            "id": "4de5bbef-e7af-4055-9ded-e2c457e9045e",
            "type": "communications-template_stages",
            "attributes": {
              "email_body": "Ducimus sequi dolores molestiae.",
              "email_subject": "2f1k4rz5o9",
              "slack_content": "Porro voluptas ab tenetur.",
              "sms_content": "Ullam autem quia cumque.",
              "created_at": "2025-11-27T00:06:49.583-08:00",
              "updated_at": "2025-11-27T00:06:49.583-08:00",
              "communication_stage": {
                "id": "3be85e68-d589-4405-94c5-850eba905162",
                "name": "3lwa4"
              },
              "communication_template": {
                "id": "1e233eb9-5d0b-40e8-9e35-72642a9ccc65",
                "name": "Updated Template Name"
              }
            }
          }
        }
      ]
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Communications Template ID

Body

application/vnd.api+json
​
data
object
required

Response

communications template updated

​
data
object
required