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": "f316f7a3-0c95-4658-b9b5-a47ba4b0d28f",
    "type": "incident_action_items",
    "attributes": {
      "incident_id": "5843767e-6b68-41e8-83d1-93c63bfdbb70",
      "incident_title": "Est sit veniam recusandae.",
      "description": "New action item description",
      "assigned_to": {
        "id": 188,
        "ability_cache": {
          "team_ids": [
            166
          ],
          "administrating_team_ids": []
        },
        "accept_marketing": true,
        "accept_terms": true,
        "created_at": "2025-09-03T02:21:26.855-07:00",
        "created_through_sso": false,
        "current_team_id": 166,
        "deleted_at": null,
        "email": "vada.grant@gleason.example",
        "external_id": null,
        "first_name": "Slyvia",
        "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": "f633c2bc-3b7a-4235-887a-aa128a326fdc",
        "last_name": "Harvey",
        "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_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": "2025-09-03T02:21:30.399-07:00",
        "victor_ops_id": null,
        "view_multiple_schedules": true
      },
      "assigned_to_group_ids": [
        "607d7df6-e639-4faf-ad5f-d79c6f7e35fb",
        "3c84f70b-cb70-4d8e-ba13-21f0179ff878"
      ],
      "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/est-sit-veniam-recusandae#nav-action-items",
      "short_url": null,
      "created_at": "2025-09-03T02:21:30.573-07:00",
      "updated_at": "2025-09-03T02:21:30.573-07: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

Response

201
application/vnd.api+json

incident_action_item created

The response is of type object.