Creates a new action item from provided data
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": "ac348cce-539e-4feb-8e63-c15a816ab333",
"type": "incident_action_items",
"attributes": {
"incident_id": "76e27009-efed-49a6-be80-bf0a5c2ae25e",
"incident_title": "Fuga fugiat asperiores iusto.",
"description": "New action item description",
"assigned_to": {
"id": 234,
"ability_cache": {
"team_ids": [
233
],
"administrating_team_ids": []
},
"accept_marketing": true,
"accept_terms": true,
"created_at": "2025-12-08T08:27:22.716-08:00",
"created_through_sso": false,
"current_team_id": 233,
"deleted_at": null,
"email": "[email protected]",
"external_id": null,
"first_name": "Sanford",
"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": "e98fa8ae-c5be-48e3-be0c-2ace8b982c1d",
"last_name": "Stokes",
"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-12-08T08:27:26.500-08:00",
"victor_ops_id": null,
"view_multiple_schedules": true
},
"assigned_to_group_ids": [
"b900da53-bd28-4949-859c-5760e955005c",
"1e86f272-be54-4cbd-886c-67f8ffdc2003"
],
"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/fuga-fugiat-asperiores-iusto#nav-action-items",
"short_url": null,
"created_by": {
"data": {
"id": "234",
"type": "users",
"attributes": {
"name": "Sanford Stokes",
"email": "[email protected]",
"phone": null,
"phone_2": null,
"first_name": "Sanford",
"last_name": "Stokes",
"full_name": "Sanford Stokes",
"full_name_with_team": "[Smith-Daniel] Sanford Stokes",
"slack_id": null,
"time_zone": "Etc/UTC",
"updated_at": "2025-12-08T08:27:26.500-08:00",
"created_at": "2025-12-08T08:27:22.716-08:00"
},
"relationships": {
"email_addresses": {
"data": [
{
"id": "65023ea1-32cd-4604-921b-9b2594e0a903",
"type": "user_email_addresses"
}
]
},
"phone_numbers": {
"data": []
},
"devices": {
"data": []
},
"role": {
"data": {
"id": "6cd3b248-4e00-4a69-bc6a-325262cdecb4",
"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": "2025-12-08T08:27:22.915-08:00",
"deleted_at": null,
"display_order": 2,
"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": "1288cbbd-af3a-4780-acd5-158ff1fcc350",
"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": 233,
"updated_at": "2025-12-08T08:27:22.915-08:00",
"webhooks_permissions": [],
"workflows_permissions": [
"create",
"read",
"update",
"delete"
]
}
},
"on_call_role": {
"data": {
"id": "cccbfad5-c4be-4c06-b22c-efe2006fe9de",
"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": "2025-12-08T08:27:22.936-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": 233,
"updated_at": "2025-12-08T08:27:22.936-08:00",
"webhooks_permissions": [],
"workflows_permissions": []
}
},
"teams": {
"data": []
},
"schedules": {
"data": []
},
"notification_rules": {
"data": [
{
"id": "d9a0d264-e0db-44a0-a564-f5832d7a0ecc",
"type": "user_notification_rules"
},
{
"id": "aed79af1-a3a7-465a-beff-7ae525cede8e",
"type": "user_notification_rules"
}
]
}
}
}
},
"created_at": "2025-12-08T08:27:26.644-08:00",
"updated_at": "2025-12-08T08:27:26.644-08:00",
"summary": "New action item summary"
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
incident_action_items Show child attributes
The summary of the action item
The description of the action item
The kind of the action item
task, follow_up ID of user you wish to assign this action item
IDs of groups you wish to assign this action item
The priority of the action item
high, medium, low The status of the action item
open, in_progress, cancelled, done The due date of the action item
The Jira issue ID.
The Jira issue key.
The Jira issue URL.
incident_action_item created
Show child attributes
Unique ID of the action item
incident_action_items Show child attributes
The summary of the action item
Date of creation
Date of last update
The description of incident action item
The kind of the action item
task, follow_up User assigned to this action item Flat user object as returned by serializer
Show child attributes
User ID
User email
User creation timestamp
User last update timestamp
User first name
User last name
User full name
User full name with team
User time zone
IDs of groups you wish to assign this action item
The priority of the action item
high, medium, low The status of the action item
open, in_progress, cancelled, done The due date of the action item
The Jira issue ID.
The Jira issue key.
The Jira issue URL.
Was this page helpful?
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": "ac348cce-539e-4feb-8e63-c15a816ab333",
"type": "incident_action_items",
"attributes": {
"incident_id": "76e27009-efed-49a6-be80-bf0a5c2ae25e",
"incident_title": "Fuga fugiat asperiores iusto.",
"description": "New action item description",
"assigned_to": {
"id": 234,
"ability_cache": {
"team_ids": [
233
],
"administrating_team_ids": []
},
"accept_marketing": true,
"accept_terms": true,
"created_at": "2025-12-08T08:27:22.716-08:00",
"created_through_sso": false,
"current_team_id": 233,
"deleted_at": null,
"email": "[email protected]",
"external_id": null,
"first_name": "Sanford",
"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": "e98fa8ae-c5be-48e3-be0c-2ace8b982c1d",
"last_name": "Stokes",
"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-12-08T08:27:26.500-08:00",
"victor_ops_id": null,
"view_multiple_schedules": true
},
"assigned_to_group_ids": [
"b900da53-bd28-4949-859c-5760e955005c",
"1e86f272-be54-4cbd-886c-67f8ffdc2003"
],
"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/fuga-fugiat-asperiores-iusto#nav-action-items",
"short_url": null,
"created_by": {
"data": {
"id": "234",
"type": "users",
"attributes": {
"name": "Sanford Stokes",
"email": "[email protected]",
"phone": null,
"phone_2": null,
"first_name": "Sanford",
"last_name": "Stokes",
"full_name": "Sanford Stokes",
"full_name_with_team": "[Smith-Daniel] Sanford Stokes",
"slack_id": null,
"time_zone": "Etc/UTC",
"updated_at": "2025-12-08T08:27:26.500-08:00",
"created_at": "2025-12-08T08:27:22.716-08:00"
},
"relationships": {
"email_addresses": {
"data": [
{
"id": "65023ea1-32cd-4604-921b-9b2594e0a903",
"type": "user_email_addresses"
}
]
},
"phone_numbers": {
"data": []
},
"devices": {
"data": []
},
"role": {
"data": {
"id": "6cd3b248-4e00-4a69-bc6a-325262cdecb4",
"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": "2025-12-08T08:27:22.915-08:00",
"deleted_at": null,
"display_order": 2,
"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": "1288cbbd-af3a-4780-acd5-158ff1fcc350",
"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": 233,
"updated_at": "2025-12-08T08:27:22.915-08:00",
"webhooks_permissions": [],
"workflows_permissions": [
"create",
"read",
"update",
"delete"
]
}
},
"on_call_role": {
"data": {
"id": "cccbfad5-c4be-4c06-b22c-efe2006fe9de",
"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": "2025-12-08T08:27:22.936-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": 233,
"updated_at": "2025-12-08T08:27:22.936-08:00",
"webhooks_permissions": [],
"workflows_permissions": []
}
},
"teams": {
"data": []
},
"schedules": {
"data": []
},
"notification_rules": {
"data": [
{
"id": "d9a0d264-e0db-44a0-a564-f5832d7a0ecc",
"type": "user_notification_rules"
},
{
"id": "aed79af1-a3a7-465a-beff-7ae525cede8e",
"type": "user_notification_rules"
}
]
}
}
}
},
"created_at": "2025-12-08T08:27:26.644-08:00",
"updated_at": "2025-12-08T08:27:26.644-08:00",
"summary": "New action item summary"
}
}
}