Update a specific functionality by id
curl --request PUT \
--url https://api.rootly.com/v1/functionalities/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "functionalities",
"attributes": {
"name": "<string>",
"description": "<string>",
"public_description": "<string>",
"notify_emails": [
"<string>"
],
"color": "<string>",
"position": 123,
"backstage_id": "<string>",
"external_id": "<string>",
"pagerduty_id": "<string>",
"opsgenie_id": "<string>",
"opsgenie_team_id": "<string>",
"cortex_id": "<string>",
"service_now_ci_sys_id": "<string>",
"environment_ids": [
"<string>"
],
"service_ids": [
"<string>"
],
"owner_group_ids": [
"<string>"
],
"owner_user_ids": [
123
],
"slack_channels": [
{
"id": "<string>",
"name": "<string>"
}
],
"slack_aliases": [
{
"id": "<string>",
"name": "<string>"
}
]
}
}
}
'{
"data": {
"id": "1b8a097f-1916-4c2e-8ab9-421391629b5d",
"type": "functionalities",
"attributes": {
"name": "Checkout",
"slug": "temporibus-eligendi-id-quas",
"description": "Users should be able to checkout",
"public_description": "Public description updated",
"notify_emails": [
"[email protected]",
"[email protected]"
],
"color": "#000",
"status": "partial_outage",
"position": 2,
"show_uptime": true,
"show_uptime_last_days": 60,
"slack_channels": [
{
"id": "C03MKDSEJE8",
"name": "elastisearch"
}
],
"slack_aliases": [
{
"id": "S03F7QUV7F1",
"name": "leadership"
}
],
"backstage_id": null,
"external_id": "33bfcc62-cc35-46e6-a270-8c52a56fb358",
"opsgenie_id": "8743a1b2-11da-480e-8493-744660987bec",
"pagerduty_id": "PQ9K7I9",
"cortex_id": null,
"opslevel_id": null,
"service_now_ci_sys_id": null,
"environment_ids": [
"306f2928-5199-48f2-ad3d-dd09500d6721"
],
"service_ids": [],
"owner_group_ids": [],
"owners_group_ids": [],
"owner_user_ids": [],
"owners_user_ids": [],
"incidents_count": 1,
"created_at": "2025-12-10T16:22:49.928-08:00",
"updated_at": "2025-12-10T16:22:56.117-08:00"
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Resource UUID
Show child attributes
functionalities Show child attributes
The name of the functionality
The description of the functionality
The public description of the functionality
Emails to attach to the functionality
The hex color of the functionality
Position of the functionality
The Backstage entity id associated to this functionality. eg: :namespace/:kind/:entity_name
The external id associated to this functionality
The PagerDuty service id associated to this functionality
The Opsgenie service id associated to this functionality
The Opsgenie team id associated to this functionality
The Cortex group id associated to this functionality
The Service Now CI sys id associated to this functionality
Environments associated with this functionality
Services associated with this functionality
Owner Teams associated with this functionality
Owner Users associated with this functionality
functionality updated
Show child attributes
Unique ID of the functionality
functionalities Show child attributes
The name of the functionality
Date of creation
Date of last update
The slug of the functionality
The description of the functionality
The public description of the functionality
Emails attached to the functionality
The hex color of the functionality
The Backstage entity id associated to this functionality. eg: :namespace/:kind/:entity_name
The external id associated to this functionality
The PagerDuty service id associated to this functionality
The Opsgenie service id associated to this functionality
The Opsgenie team id associated to this functionality
The Cortex group id associated to this functionality
The Service Now CI sys id associated to this functionality
Position of the functionality
Environments associated with this functionality
Services associated with this functionality
Owner Teams associated with this functionality
Owner Users associated with this functionality
Was this page helpful?
curl --request PUT \
--url https://api.rootly.com/v1/functionalities/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "functionalities",
"attributes": {
"name": "<string>",
"description": "<string>",
"public_description": "<string>",
"notify_emails": [
"<string>"
],
"color": "<string>",
"position": 123,
"backstage_id": "<string>",
"external_id": "<string>",
"pagerduty_id": "<string>",
"opsgenie_id": "<string>",
"opsgenie_team_id": "<string>",
"cortex_id": "<string>",
"service_now_ci_sys_id": "<string>",
"environment_ids": [
"<string>"
],
"service_ids": [
"<string>"
],
"owner_group_ids": [
"<string>"
],
"owner_user_ids": [
123
],
"slack_channels": [
{
"id": "<string>",
"name": "<string>"
}
],
"slack_aliases": [
{
"id": "<string>",
"name": "<string>"
}
]
}
}
}
'{
"data": {
"id": "1b8a097f-1916-4c2e-8ab9-421391629b5d",
"type": "functionalities",
"attributes": {
"name": "Checkout",
"slug": "temporibus-eligendi-id-quas",
"description": "Users should be able to checkout",
"public_description": "Public description updated",
"notify_emails": [
"[email protected]",
"[email protected]"
],
"color": "#000",
"status": "partial_outage",
"position": 2,
"show_uptime": true,
"show_uptime_last_days": 60,
"slack_channels": [
{
"id": "C03MKDSEJE8",
"name": "elastisearch"
}
],
"slack_aliases": [
{
"id": "S03F7QUV7F1",
"name": "leadership"
}
],
"backstage_id": null,
"external_id": "33bfcc62-cc35-46e6-a270-8c52a56fb358",
"opsgenie_id": "8743a1b2-11da-480e-8493-744660987bec",
"pagerduty_id": "PQ9K7I9",
"cortex_id": null,
"opslevel_id": null,
"service_now_ci_sys_id": null,
"environment_ids": [
"306f2928-5199-48f2-ad3d-dd09500d6721"
],
"service_ids": [],
"owner_group_ids": [],
"owners_group_ids": [],
"owner_user_ids": [],
"owners_user_ids": [],
"incidents_count": 1,
"created_at": "2025-12-10T16:22:49.928-08:00",
"updated_at": "2025-12-10T16:22:56.117-08:00"
}
}
}