Skip to main content
POST
/
v1
/
incidents
/
{incident_id}
/
action_items
Creates an incident action item
curl --request POST \
  --url https://api.rootly.com/v1/incidents/{incident_id}/action_items \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '
{
  "data": {
    "type": "incident_action_items",
    "attributes": {
      "summary": "<string>",
      "description": "<string>",
      "kind": "task",
      "assigned_to_user_id": 123,
      "assigned_to_group_ids": [
        "<string>"
      ],
      "priority": "high",
      "status": "open",
      "due_date": "<string>",
      "jira_issue_id": "<string>",
      "jira_issue_key": "<string>",
      "jira_issue_url": "<string>"
    }
  }
}
'
{
  "data": {
    "id": "c4c06cc1-c5f1-4d65-90c2-80d2fb2bb61b",
    "type": "incident_action_items",
    "attributes": {
      "incident_id": "cd18722b-a85d-4459-bb8c-1489811e5744",
      "incident_title": "Dicta asperiores suscipit ex.",
      "description": "New action item description",
      "assigned_to": {
        "id": 434,
        "ability_cache": {
          "team_ids": [
            275
          ],
          "administrating_team_ids": []
        },
        "accept_marketing": true,
        "accept_terms": true,
        "created_at": "2026-01-16T07:09:21.398-08:00",
        "created_through_sso": false,
        "current_team_id": 275,
        "deleted_at": null,
        "email": "[email protected]",
        "external_id": null,
        "first_name": "Arden",
        "has_impersonate_write_permission": false,
        "how_did_you_hear_about_us": null,
        "incidents_backfilled_count": 0,
        "incidents_count": 0,
        "incidents_example_count": 0,
        "incidents_normal_count": 0,
        "incidents_scheduled_count": 0,
        "incidents_test_count": 0,
        "is_super_admin": false,
        "jti": "d517b7ca-25b0-4860-b45f-d966e73c9fbe",
        "last_name": "Waters",
        "last_notification_email_sent_at": null,
        "last_seen_at": null,
        "locale": "en",
        "onboarding_completed": true,
        "opsgenie_id": null,
        "pagerduty_id": null,
        "profile_photo_id": null,
        "push_notification_new_alert_sound": "default",
        "push_notification_new_alert_volume": 1,
        "push_notification_shift_coverage_sound": "soft_bloob",
        "push_notification_shift_ends_sound": "soft_bloob",
        "push_notification_shift_starts_sound": "soft_bloob",
        "scim_uid": null,
        "service_user": false,
        "session_token": null,
        "skip_tutorial": false,
        "teams_count": 1,
        "theme": "light_v2",
        "time_zone": "UTC",
        "updated_at": "2026-01-16T07:09:24.198-08:00",
        "victor_ops_id": null,
        "view_multiple_schedules": true
      },
      "assigned_to_group_ids": [
        "7503ef0a-90a2-4493-9918-33d40a9edd5f",
        "4d3bf4b4-a9b3-4d46-9057-527672aff5e9"
      ],
      "kind": "task",
      "priority": "medium",
      "status": "open",
      "due_date": null,
      "jira_issue_id": null,
      "jira_issue_key": null,
      "jira_issue_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,
      "shortcut_story_id": null,
      "shortcut_story_url": null,
      "shortcut_task_id": null,
      "shortcut_task_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,
      "airtable_base_key": null,
      "airtable_table_name": null,
      "airtable_record_id": null,
      "airtable_record_url": null,
      "freshservice_ticket_id": null,
      "freshservice_ticket_url": null,
      "freshservice_task_id": null,
      "freshservice_task_url": null,
      "url": "https://test.rootly.com/account/incidents/dicta-asperiores-suscipit-ex#nav-action-items",
      "short_url": null,
      "created_by": {
        "data": {
          "id": "434",
          "type": "users",
          "attributes": {
            "name": "Arden Waters",
            "email": "[email protected]",
            "phone": null,
            "phone_2": null,
            "first_name": "Arden",
            "last_name": "Waters",
            "full_name": "Arden Waters",
            "full_name_with_team": "[Kilback LLC] Arden Waters",
            "slack_id": null,
            "time_zone": "Etc/UTC",
            "updated_at": "2026-01-16T07:09:24.198-08:00",
            "created_at": "2026-01-16T07:09:21.398-08:00"
          },
          "relationships": {
            "email_addresses": {
              "data": [
                {
                  "id": "232f7cfa-e7e0-4f1b-ad17-7a88e500c5b0",
                  "type": "user_email_addresses"
                }
              ]
            },
            "phone_numbers": {
              "data": []
            },
            "devices": {
              "data": []
            },
            "role": {
              "data": {
                "id": "6fc6d5f7-2b8a-4b7d-b26c-55ee29a852df",
                "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-01-16T07:09:21.551-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": "882c3233-cf86-41ec-82f3-04b1b01777c8",
                "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": 275,
                "updated_at": "2026-01-16T07:09:21.551-08:00",
                "webhooks_permissions": [],
                "workflows_permissions": [
                  "create",
                  "read",
                  "update",
                  "delete"
                ]
              }
            },
            "on_call_role": {
              "data": {
                "id": "73309105-1ae1-4997-8353-e5ad0a7e2671",
                "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-01-16T07:09:21.566-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": 275,
                "updated_at": "2026-01-16T07:09:21.566-08:00",
                "webhooks_permissions": [],
                "workflows_permissions": []
              }
            },
            "teams": {
              "data": []
            },
            "schedules": {
              "data": []
            },
            "notification_rules": {
              "data": [
                {
                  "id": "299ac850-77c5-4071-9580-7d405ed4cd97",
                  "type": "user_notification_rules"
                },
                {
                  "id": "abb69594-2334-4622-bc4e-451dcdcd0dbc",
                  "type": "user_notification_rules"
                }
              ]
            }
          }
        }
      },
      "created_at": "2026-01-16T07:09:24.290-08:00",
      "updated_at": "2026-01-16T07:09:24.290-08:00",
      "summary": "New action item summary"
    }
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

incident_id
string
required

Body

application/vnd.api+json
data
object
required

Response

incident_action_item created

data
object
required