Skip to main content
POST
/
v1
/
incidents
/
{id}
/
assign_role_to_user
Assign user to incident
curl --request POST \
  --url https://api.rootly.com/v1/incidents/{id}/assign_role_to_user \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '
{
  "data": {
    "type": "incidents",
    "attributes": {
      "user_id": "<string>",
      "incident_role_id": "<string>"
    }
  }
}
'
{
  "data": {
    "id": "13b9a33c-c8aa-4f48-85fe-cbda49554d25",
    "type": "incidents",
    "attributes": {
      "parent_incident_id": null,
      "sequential_id": 1,
      "title": "Repudiandae et iure eos.",
      "slug": "repudiandae-et-iure-eos",
      "kind": "normal",
      "private": false,
      "summary": "Minima saepe perspiciatis. Enim reiciendis hic. Ex eum consequatur.",
      "status": "started",
      "source": "web",
      "url": "http://localhost:3001/account/incidents/1-repudiandae-et-iure-eos",
      "short_url": null,
      "user": {
        "data": {
          "id": "776",
          "type": "users",
          "attributes": {
            "name": "Marna Hermann",
            "email": "[email protected]",
            "phone": null,
            "phone_2": null,
            "first_name": "Marna",
            "last_name": "Hermann",
            "full_name": "Marna Hermann",
            "full_name_with_team": "[Anderson and Sons] Marna Hermann",
            "slack_id": null,
            "time_zone": "Etc/UTC",
            "updated_at": "2026-02-13T18:08:26.995-08:00",
            "created_at": "2026-02-13T18:08:26.560-08:00"
          },
          "relationships": {
            "email_addresses": {
              "data": [
                {
                  "id": "a4fe8fcf-e125-4f01-956c-24534b26038a",
                  "type": "user_email_addresses"
                }
              ]
            },
            "phone_numbers": {
              "data": []
            },
            "devices": {
              "data": []
            },
            "role": {
              "data": {
                "id": "09603eab-20f5-4e81-a42e-0a782fdc3599",
                "alerts_permissions": [
                  "create",
                  "read"
                ],
                "api_keys_permissions": [
                  "create",
                  "update",
                  "read",
                  "delete"
                ],
                "audits_permissions": [],
                "billing_permissions": [],
                "catalogs_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "communication_permissions": [
                  "read"
                ],
                "created_at": "2026-02-13T18:08:26.194-08:00",
                "deleted_at": null,
                "display_order": 2,
                "edge_connector_permissions": [],
                "environments_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "form_fields_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "functionalities_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "groups_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incident_causes_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incident_communication_permissions": [
                  "read"
                ],
                "incident_feedbacks_permissions": [
                  "read",
                  "create",
                  "update"
                ],
                "incident_permission_set_id": "62c58cae-db58-44b2-b6c7-58937d636c87",
                "incident_roles_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incident_types_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incidents_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "integrations_permissions": [],
                "invitations_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "is_deletable": false,
                "is_editable": true,
                "name": "user",
                "paging_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "playbooks_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "private_incidents_permissions": [],
                "pulses_permissions": [
                  "create",
                  "update",
                  "read"
                ],
                "retrospective_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "roles_permissions": [],
                "secrets_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "services_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "severities_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "slug": "user",
                "status_pages_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "sub_statuses_permissions": [
                  "read"
                ],
                "team_id": 462,
                "updated_at": "2026-02-13T18:08:26.194-08:00",
                "webhooks_permissions": [],
                "workflows_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ]
              }
            },
            "on_call_role": {
              "data": {
                "id": "f4994422-40d4-4eb4-b4a5-07eb8082afd2",
                "alert_fields_permissions": [],
                "alert_groups_permissions": [],
                "alert_routing_rules_permissions": [],
                "alert_sources_permissions": [],
                "alert_urgency_permissions": [],
                "alerts_permissions": [],
                "api_keys_permissions": [],
                "audits_permissions": [],
                "contacts_permissions": [],
                "created_at": "2026-02-13T18:08:26.203-08:00",
                "deleted_at": null,
                "escalation_policies_permissions": [],
                "groups_permissions": [],
                "heartbeats_permissions": [],
                "integrations_permissions": [],
                "invitations_permissions": [],
                "live_call_routing_permissions": [],
                "name": "None",
                "on_call_readiness_report_permissions": [],
                "on_call_roles_permissions": [],
                "schedule_override_permissions": [],
                "schedules_permissions": [],
                "services_permissions": [],
                "shift_overrides_permissions": [],
                "slug": "none",
                "system_role": "no_access",
                "team_id": 462,
                "updated_at": "2026-02-13T18:08:26.203-08:00",
                "webhooks_permissions": [],
                "workflows_permissions": []
              }
            },
            "teams": {
              "data": []
            },
            "schedules": {
              "data": []
            },
            "notification_rules": {
              "data": [
                {
                  "id": "371866e1-fae1-4d18-9d67-82f970a73294",
                  "type": "user_notification_rules"
                },
                {
                  "id": "ba50fbfd-d837-4372-a883-c65fe62c2ede",
                  "type": "user_notification_rules"
                }
              ]
            }
          }
        }
      },
      "severity": {
        "data": {
          "id": "27c8f0c6-6cb3-45fa-84e2-b3f41c465007",
          "type": "severities",
          "attributes": {
            "name": "e89do",
            "slug": "e89do",
            "description": "Voluptatum aliquam molestias doloremque.",
            "severity": "medium",
            "color": "#E58A1F",
            "position": 1,
            "notify_emails": [],
            "slack_channels": [],
            "slack_aliases": [],
            "created_at": "2026-02-13T18:08:26.977-08:00",
            "updated_at": "2026-02-13T18:08:26.977-08:00"
          }
        }
      },
      "in_triage_by": null,
      "started_by": {
        "data": {
          "id": "776",
          "type": "users",
          "attributes": {
            "name": "Marna Hermann",
            "email": "[email protected]",
            "phone": null,
            "phone_2": null,
            "first_name": "Marna",
            "last_name": "Hermann",
            "full_name": "Marna Hermann",
            "full_name_with_team": "[Anderson and Sons] Marna Hermann",
            "slack_id": null,
            "time_zone": "Etc/UTC",
            "updated_at": "2026-02-13T18:08:26.995-08:00",
            "created_at": "2026-02-13T18:08:26.560-08:00"
          },
          "relationships": {
            "email_addresses": {
              "data": [
                {
                  "id": "a4fe8fcf-e125-4f01-956c-24534b26038a",
                  "type": "user_email_addresses"
                }
              ]
            },
            "phone_numbers": {
              "data": []
            },
            "devices": {
              "data": []
            },
            "role": {
              "data": {
                "id": "09603eab-20f5-4e81-a42e-0a782fdc3599",
                "alerts_permissions": [
                  "create",
                  "read"
                ],
                "api_keys_permissions": [
                  "create",
                  "update",
                  "read",
                  "delete"
                ],
                "audits_permissions": [],
                "billing_permissions": [],
                "catalogs_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "communication_permissions": [
                  "read"
                ],
                "created_at": "2026-02-13T18:08:26.194-08:00",
                "deleted_at": null,
                "display_order": 2,
                "edge_connector_permissions": [],
                "environments_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "form_fields_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "functionalities_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "groups_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incident_causes_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incident_communication_permissions": [
                  "read"
                ],
                "incident_feedbacks_permissions": [
                  "read",
                  "create",
                  "update"
                ],
                "incident_permission_set_id": "62c58cae-db58-44b2-b6c7-58937d636c87",
                "incident_roles_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incident_types_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "incidents_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "integrations_permissions": [],
                "invitations_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "is_deletable": false,
                "is_editable": true,
                "name": "user",
                "paging_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "playbooks_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "private_incidents_permissions": [],
                "pulses_permissions": [
                  "create",
                  "update",
                  "read"
                ],
                "retrospective_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "roles_permissions": [],
                "secrets_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "services_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "severities_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "slug": "user",
                "status_pages_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ],
                "sub_statuses_permissions": [
                  "read"
                ],
                "team_id": 462,
                "updated_at": "2026-02-13T18:08:26.194-08:00",
                "webhooks_permissions": [],
                "workflows_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ]
              }
            },
            "on_call_role": {
              "data": {
                "id": "f4994422-40d4-4eb4-b4a5-07eb8082afd2",
                "alert_fields_permissions": [],
                "alert_groups_permissions": [],
                "alert_routing_rules_permissions": [],
                "alert_sources_permissions": [],
                "alert_urgency_permissions": [],
                "alerts_permissions": [],
                "api_keys_permissions": [],
                "audits_permissions": [],
                "contacts_permissions": [],
                "created_at": "2026-02-13T18:08:26.203-08:00",
                "deleted_at": null,
                "escalation_policies_permissions": [],
                "groups_permissions": [],
                "heartbeats_permissions": [],
                "integrations_permissions": [],
                "invitations_permissions": [],
                "live_call_routing_permissions": [],
                "name": "None",
                "on_call_readiness_report_permissions": [],
                "on_call_roles_permissions": [],
                "schedule_override_permissions": [],
                "schedules_permissions": [],
                "services_permissions": [],
                "shift_overrides_permissions": [],
                "slug": "none",
                "system_role": "no_access",
                "team_id": 462,
                "updated_at": "2026-02-13T18:08:26.203-08:00",
                "webhooks_permissions": [],
                "workflows_permissions": []
              }
            },
            "teams": {
              "data": []
            },
            "schedules": {
              "data": []
            },
            "notification_rules": {
              "data": [
                {
                  "id": "371866e1-fae1-4d18-9d67-82f970a73294",
                  "type": "user_notification_rules"
                },
                {
                  "id": "ba50fbfd-d837-4372-a883-c65fe62c2ede",
                  "type": "user_notification_rules"
                }
              ]
            }
          }
        }
      },
      "mitigated_by": null,
      "resolved_by": null,
      "closed_by": null,
      "cancelled_by": null,
      "mitigation_message": null,
      "resolution_message": null,
      "cancellation_message": null,
      "public_title": null,
      "duplicate_incident_id": null,
      "retrospective_progress_status": "not_started",
      "zoom_meeting_id": null,
      "zoom_meeting_start_url": null,
      "zoom_meeting_join_url": null,
      "zoom_meeting_password": null,
      "zoom_meeting_pstn_password": null,
      "zoom_meeting_h323_password": null,
      "zoom_meeting_global_dial_in_numbers": [],
      "shortcut_story_id": null,
      "shortcut_story_url": null,
      "shortcut_task_id": null,
      "shortcut_task_url": null,
      "asana_task_id": null,
      "asana_task_url": null,
      "github_issue_id": null,
      "github_issue_url": null,
      "gitlab_issue_id": null,
      "gitlab_issue_url": null,
      "jira_issue_key": null,
      "jira_issue_id": null,
      "jira_issue_url": null,
      "google_meeting_id": null,
      "google_meeting_url": null,
      "trello_card_id": null,
      "trello_card_url": null,
      "linear_issue_id": null,
      "linear_issue_url": null,
      "zendesk_ticket_id": null,
      "zendesk_ticket_url": null,
      "motion_task_id": null,
      "motion_task_url": null,
      "clickup_task_id": null,
      "clickup_task_url": null,
      "slack_channel_name": null,
      "slack_channel_id": null,
      "slack_channel_url": null,
      "slack_channel_short_url": null,
      "slack_channel_deep_link": null,
      "slack_channel_archived": false,
      "slack_last_message_ts": null,
      "service_now_incident_id": null,
      "service_now_incident_key": null,
      "service_now_incident_url": null,
      "opsgenie_incident_id": null,
      "opsgenie_incident_url": null,
      "opsgenie_alert_id": null,
      "opsgenie_alert_url": null,
      "victor_ops_incident_id": null,
      "victor_ops_incident_url": null,
      "pagerduty_incident_id": null,
      "pagerduty_incident_number": null,
      "pagerduty_incident_url": null,
      "mattermost_channel_id": null,
      "mattermost_channel_name": null,
      "mattermost_channel_url": null,
      "confluence_page_id": null,
      "confluence_page_url": null,
      "quip_page_id": null,
      "quip_page_url": null,
      "airtable_base_key": null,
      "airtable_table_name": null,
      "airtable_record_id": null,
      "airtable_record_url": null,
      "google_drive_id": null,
      "google_drive_parent_id": null,
      "google_drive_url": null,
      "sharepoint_page_id": null,
      "sharepoint_page_url": null,
      "datadog_notebook_id": null,
      "datadog_notebook_url": null,
      "freshservice_ticket_id": null,
      "freshservice_ticket_url": null,
      "freshservice_task_id": null,
      "freshservice_task_url": null,
      "scheduled_for": null,
      "scheduled_until": null,
      "in_triage_at": null,
      "started_at": "2026-02-13T18:08:26.981-08:00",
      "detected_at": null,
      "acknowledged_at": null,
      "mitigated_at": null,
      "resolved_at": null,
      "closed_at": null,
      "cancelled_at": null,
      "created_at": "2026-02-13T18:08:26.981-08:00",
      "updated_at": "2026-02-13T18:08:47.990-08:00",
      "muted_service_ids": [],
      "labels": {}
    },
    "relationships": {
      "causes": {
        "data": []
      },
      "subscribers": {
        "data": [
          {
            "id": "04ca25ae-7f7c-4ac4-a5fa-78c5e7c381e3",
            "type": "incident_subscribers"
          }
        ]
      },
      "roles": {
        "data": [
          {
            "id": "f8e40015-4d75-4bab-a536-3a8e63fbbcb5",
            "type": "incident_role_assignments"
          }
        ]
      },
      "environments": {
        "data": []
      },
      "incident_types": {
        "data": []
      },
      "services": {
        "data": []
      },
      "functionalities": {
        "data": []
      },
      "groups": {
        "data": []
      },
      "events": {
        "data": [
          {
            "id": "2563b43d-73c0-4321-8e3e-9635496bddbe",
            "type": "incident_events"
          },
          {
            "id": "2984efc6-6ba0-43a1-9343-6af6ec2d45ca",
            "type": "incident_events"
          },
          {
            "id": "9291397b-92bf-4d2b-a8ca-70bd513906bf",
            "type": "incident_events"
          }
        ]
      },
      "action_items": {
        "data": []
      },
      "custom_field_selections": {
        "data": []
      },
      "feedbacks": {
        "data": []
      },
      "attachments": {
        "data": []
      },
      "slack_messages": {
        "data": []
      },
      "alerts": {
        "data": []
      }
    }
  },
  "included": [
    {
      "id": "f8e40015-4d75-4bab-a536-3a8e63fbbcb5",
      "type": "incident_role_assignments",
      "attributes": {
        "incident_role": {
          "data": {
            "id": "b385784d-8f0c-4f12-8d5e-dc5ae7fddfbb",
            "type": "incident_roles",
            "attributes": {
              "slug": "perferendis-beatae-unde-in",
              "name": "Perferendis beatae unde in.",
              "summary": null,
              "description": null,
              "position": 1,
              "optional": false,
              "enabled": true,
              "allow_multi_user_assignment": false,
              "created_at": "2026-02-13T18:08:29.861-08:00",
              "updated_at": "2026-02-13T18:08:29.861-08:00"
            }
          }
        },
        "user": {
          "data": {
            "id": "774",
            "type": "users",
            "attributes": {
              "name": "Nakia Larkin",
              "email": "[email protected]",
              "phone": null,
              "phone_2": null,
              "first_name": "Nakia",
              "last_name": "Larkin",
              "full_name": "Nakia Larkin",
              "full_name_with_team": "[Anderson and Sons] Nakia Larkin",
              "slack_id": null,
              "time_zone": "Etc/UTC",
              "updated_at": "2026-02-13T18:08:47.888-08:00",
              "created_at": "2026-02-13T18:08:26.064-08:00"
            },
            "relationships": {
              "email_addresses": {
                "data": [
                  {
                    "id": "06085771-2ae3-412c-9fed-776c746a28bd",
                    "type": "user_email_addresses"
                  }
                ]
              },
              "phone_numbers": {
                "data": []
              },
              "devices": {
                "data": []
              },
              "role": {
                "data": {
                  "id": "09603eab-20f5-4e81-a42e-0a782fdc3599",
                  "alerts_permissions": [
                    "create",
                    "read"
                  ],
                  "api_keys_permissions": [
                    "create",
                    "update",
                    "read",
                    "delete"
                  ],
                  "audits_permissions": [],
                  "billing_permissions": [],
                  "catalogs_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "communication_permissions": [
                    "read"
                  ],
                  "created_at": "2026-02-13T18:08:26.194-08:00",
                  "deleted_at": null,
                  "display_order": 2,
                  "edge_connector_permissions": [],
                  "environments_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "form_fields_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "functionalities_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "groups_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "incident_causes_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "incident_communication_permissions": [
                    "read"
                  ],
                  "incident_feedbacks_permissions": [
                    "read",
                    "create",
                    "update"
                  ],
                  "incident_permission_set_id": "62c58cae-db58-44b2-b6c7-58937d636c87",
                  "incident_roles_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "incident_types_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "incidents_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "integrations_permissions": [],
                  "invitations_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "is_deletable": false,
                  "is_editable": true,
                  "name": "user",
                  "paging_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "playbooks_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "private_incidents_permissions": [],
                  "pulses_permissions": [
                    "create",
                    "update",
                    "read"
                  ],
                  "retrospective_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "roles_permissions": [],
                  "secrets_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "services_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "severities_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "slug": "user",
                  "status_pages_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ],
                  "sub_statuses_permissions": [
                    "read"
                  ],
                  "team_id": 462,
                  "updated_at": "2026-02-13T18:08:26.194-08:00",
                  "webhooks_permissions": [],
                  "workflows_permissions": [
                    "create",
                    "read",
                    "update",
                    "delete"
                  ]
                }
              },
              "on_call_role": {
                "data": {
                  "id": "f4994422-40d4-4eb4-b4a5-07eb8082afd2",
                  "alert_fields_permissions": [],
                  "alert_groups_permissions": [],
                  "alert_routing_rules_permissions": [],
                  "alert_sources_permissions": [],
                  "alert_urgency_permissions": [],
                  "alerts_permissions": [],
                  "api_keys_permissions": [],
                  "audits_permissions": [],
                  "contacts_permissions": [],
                  "created_at": "2026-02-13T18:08:26.203-08:00",
                  "deleted_at": null,
                  "escalation_policies_permissions": [],
                  "groups_permissions": [],
                  "heartbeats_permissions": [],
                  "integrations_permissions": [],
                  "invitations_permissions": [],
                  "live_call_routing_permissions": [],
                  "name": "None",
                  "on_call_readiness_report_permissions": [],
                  "on_call_roles_permissions": [],
                  "schedule_override_permissions": [],
                  "schedules_permissions": [],
                  "services_permissions": [],
                  "shift_overrides_permissions": [],
                  "slug": "none",
                  "system_role": "no_access",
                  "team_id": 462,
                  "updated_at": "2026-02-13T18:08:26.203-08:00",
                  "webhooks_permissions": [],
                  "workflows_permissions": []
                }
              },
              "teams": {
                "data": []
              },
              "schedules": {
                "data": []
              },
              "notification_rules": {
                "data": [
                  {
                    "id": "7ad830a2-044c-4123-a9e6-2ef5582910b4",
                    "type": "user_notification_rules"
                  },
                  {
                    "id": "050c6916-a5bd-4b1c-b8d0-b2dd10bbf717",
                    "type": "user_notification_rules"
                  }
                ]
              }
            }
          }
        },
        "updated_at": "2026-02-13T18:08:47.983-08:00",
        "created_at": "2026-02-13T18:08:47.983-08:00"
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

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

Path Parameters

id
required

Resource UUID

Body

application/vnd.api+json
data
object
required

Response

assign user to incident

data
object
required