Creates a functionality

Overview

Overview

Reference

AlertEvents
AlertGroups
AlertUrgencies
AlertSources
Alerts
Audits
Authorizations
CatalogEntities
CatalogEntityProperties
CatalogFields
Catalogs
Causes
[DEPRECATED] CustomFieldOptions
[DEPRECATED] CustomFields
CustomForms
DashboardPanels
Dashboards
Environments
EscalationPolicies
EscalationLevelsPolicies
EscalationLevelsPath
EscalationLevels
EscalationPaths
FormFieldOptions
FormFieldPlacementConditions
FormFieldPlacements
FormFieldPositions
FormFields
FormSetConditions
FormSets
Functionalities
- GET
  List functionalities
- POST
  Creates a functionality
- GET
  Retrieves a functionality
- PUT
  Update a functionality
- DEL
  Delete a functionality
- GET
  Get functionality incidents chart
- GET
  Get functionality uptime chart
WorkflowTasks
[DEPRECATED] WorkflowCustomFieldSelections
WorkflowFormFieldConditions
WorkflowGroups
WorkflowRuns
Workflows
Heartbeats
IncidentActionItems
[DEPRECATED] IncidentCustomFieldSelections
IncidentEventFunctionalities
IncidentEventServices
IncidentEvents
IncidentFeedbacks
IncidentFormFieldSelections
IncidentPermissionSetBooleans
IncidentPermissionSetResources
IncidentPermissionSets
IncidentRetrospectives
IncidentRetrospectiveSteps
IncidentRoleTasks
IncidentRoles
IncidentStatusPageEvents
IncidentSubStatuses
IncidentTypes
Incidents
IpRanges
LiveCallRouters
OnCallRoles
OnCallShadows
OverrideShifts
PlaybookTasks
Playbooks
RetrospectiveTemplates
Pulses
RetrospectiveConfigurations
RetrospectiveProcessGroupSteps
RetrospectiveProcessGroups
RetrospectiveProcesses
RetrospectiveSteps
Roles
ScheduleRotationActiveDays
ScheduleRotationUsers
ScheduleRotations
Schedules
Shifts
Secrets
Services
Severities
StatusPageTemplates
StatusPages
SubStatuses
Teams
UserNotificationRules
Users
WebhooksDeliveries
WebhooksEndpoints

POST

functionalities

curl --request POST \
  --url https://api.rootly.com/v1/functionalities \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/vnd.api+json'

{
  "data": {
    "id": "2c0f051e-98d4-4d1c-994c-08078844f1fa",
    "type": "functionalities",
    "attributes": {
      "name": "Add items to cart",
      "slug": "add-items-to-cart",
      "description": "Users should be able to add items to cart",
      "public_description": "Public description",
      "notify_emails": [
        "john@rootly.com",
        "doe@rootly.com"
      ],
      "color": "#FFF",
      "status": "operational",
      "position": 1,
      "show_uptime": true,
      "show_uptime_last_days": 60,
      "slack_channels": [
        {
          "id": "C03MKDSEJE8",
          "name": "elastisearch"
        }
      ],
      "slack_aliases": [
        {
          "id": "S03F7QUV7F1",
          "name": "engineering"
        }
      ],
      "backstage_id": null,
      "external_id": "d795fe69-acc2-4b30-92c9-3c25cbb92056",
      "opsgenie_id": "8743a1b2-11da-480e-8493-744660987bef",
      "pagerduty_id": "PQ9K7I8",
      "cortex_id": null,
      "opslevel_id": null,
      "service_now_ci_sys_id": null,
      "environment_ids": [
        "99f97f3a-8637-4d55-a365-14b21edc2f8e"
      ],
      "service_ids": [
        "abc66c62-b983-400b-b45f-6bc5321e0149"
      ],
      "owners_group_ids": [
        "46fdaf2d-d9c4-49f5-87fe-1bb04e528548"
      ],
      "owners_user_ids": [
        139
      ],
      "incidents_count": 0,
      "created_at": "2025-03-07T00:04:03.040-08:00",
      "updated_at": "2025-03-07T00:04:03.040-08:00"
    }
  }
}

Authorizations

Authorization

string

header

required

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

Body

application/vnd.api+json

data

object

required

data.type

enum<string>

required

Available options:

functionalities

data.attributes

object

required

data.attributes.name

string

required

The name of the functionality

data.attributes.description

string | null

The description of the functionality

data.attributes.public_description

string | null

The public description of the functionality

data.attributes.notify_emails

string[] | null

Emails to attach to the functionality

data.attributes.color

string | null

The hex color of the functionality

data.attributes.position

integer | null

Position of the functionality

data.attributes.backstage_id

string | null

The Backstage entity id associated to this functionality. eg: :namespace/:kind/:entity_name

data.attributes.external_id

string | null

The external id associated to this functionality

data.attributes.pagerduty_id

string | null

The PagerDuty service id associated to this functionality

data.attributes.opsgenie_id

string | null

The Opsgenie service id associated to this functionality

data.attributes.opsgenie_team_id

string | null

The Opsgenie team id associated to this functionality

data.attributes.cortex_id

string | null

The Cortex group id associated to this functionality

data.attributes.service_now_ci_sys_id

string | null

The Service Now CI sys id associated to this functionality

data.attributes.show_uptime

boolean | null

Show uptime

data.attributes.show_uptime_last_days

enum<integer> | null

default:

Show uptime over x days

Available options:

30,

60,

90

data.attributes.environment_ids

string[] | null

Environments associated with this functionality

data.attributes.service_ids

string[] | null

Services associated with this functionality

data.attributes.owners_group_ids

string[] | null

Owner Teams associated with this functionality

data.attributes.owners_user_ids

integer[] | null

Owner Users associated with this functionality

data.attributes.slack_channels

object[] | null

Slack Channels associated with this functionality

data.attributes.slack_aliases

object[] | null

Slack Aliases associated with this functionality

Response

201

application/vnd.api+json

functionality created

data

object

required

data.id

string

required

Unique ID of the functionality

data.type

enum<string>

required

Available options:

functionalities

data.attributes

object

required

data.attributes.name

string

required

The name of the functionality

data.attributes.created_at

string

required

Date of creation

data.attributes.updated_at

string

required

Date of last update

data.attributes.slug

string

The slug of the functionality

data.attributes.description

string | null

The description of the functionality

data.attributes.public_description

string | null

The public description of the functionality

data.attributes.notify_emails

string[] | null

Emails attached to the functionality

data.attributes.color

string | null

The hex color of the functionality

data.attributes.backstage_id

string | null

The Backstage entity id associated to this functionality. eg: :namespace/:kind/:entity_name

data.attributes.external_id

string | null

The external id associated to this functionality

data.attributes.pagerduty_id

string | null

The PagerDuty service id associated to this functionality

data.attributes.opsgenie_id

string | null

The Opsgenie service id associated to this functionality

data.attributes.opsgenie_team_id

string | null

The Opsgenie team id associated to this functionality

data.attributes.cortex_id

string | null

The Cortex group id associated to this functionality

data.attributes.service_now_ci_sys_id

string | null

The Service Now CI sys id associated to this functionality

data.attributes.position

integer | null

Position of the functionality

data.attributes.environment_ids

string[] | null

Environments associated with this functionality

data.attributes.service_ids

string[] | null

Services associated with this functionality

data.attributes.owners_group_ids

string[] | null

Owner Teams associated with this functionality

data.attributes.owners_user_ids

integer[] | null

Owner Users associated with this functionality

data.attributes.slack_channels

object[] | null

Slack Channels associated with this functionality

data.attributes.slack_aliases

object[] | null

Slack Aliases associated with this functionality

Was this page helpful?

Retrieves a functionalityRetrieves a specific functionality by id

curl --request POST \
  --url https://api.rootly.com/v1/functionalities \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN' \
  --header 'content-type: application/vnd.api+json'

{
  "data": {
    "id": "2c0f051e-98d4-4d1c-994c-08078844f1fa",
    "type": "functionalities",
    "attributes": {
      "name": "Add items to cart",
      "slug": "add-items-to-cart",
      "description": "Users should be able to add items to cart",
      "public_description": "Public description",
      "notify_emails": [
        "john@rootly.com",
        "doe@rootly.com"
      ],
      "color": "#FFF",
      "status": "operational",
      "position": 1,
      "show_uptime": true,
      "show_uptime_last_days": 60,
      "slack_channels": [
        {
          "id": "C03MKDSEJE8",
          "name": "elastisearch"
        }
      ],
      "slack_aliases": [
        {
          "id": "S03F7QUV7F1",
          "name": "engineering"
        }
      ],
      "backstage_id": null,
      "external_id": "d795fe69-acc2-4b30-92c9-3c25cbb92056",
      "opsgenie_id": "8743a1b2-11da-480e-8493-744660987bef",
      "pagerduty_id": "PQ9K7I8",
      "cortex_id": null,
      "opslevel_id": null,
      "service_now_ci_sys_id": null,
      "environment_ids": [
        "99f97f3a-8637-4d55-a365-14b21edc2f8e"
      ],
      "service_ids": [
        "abc66c62-b983-400b-b45f-6bc5321e0149"
      ],
      "owners_group_ids": [
        "46fdaf2d-d9c4-49f5-87fe-1bb04e528548"
      ],
      "owners_user_ids": [
        139
      ],
      "incidents_count": 0,
      "created_at": "2025-03-07T00:04:03.040-08:00",
      "updated_at": "2025-03-07T00:04:03.040-08:00"
    }
  }
}