Skip to main content

Acknowledge alert

Action ID: tools.jira_service_management.acknowledge_alert Mark an alert as acknowledged, indicating it has been received and is being acted upon. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-acknowledge-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Additional note to add.Default: null.
string | null
Display name of the request source.Default: null.
string | null
Display name of the request owner.Default: null.

Add alert note

Action ID: tools.jira_service_management.add_alert_note Add a note to an existing alert. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-notes-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
string
required
Note text to add to the alert (max 25,000 chars).
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Display name of the request source.Default: null.
string | null
Display name of the request owner.Default: null.

Add comment to service request

Action ID: tools.jira_service_management.add_request_comment Add a comment to a service request in Jira Service Management. Supports setting visibility to public (customer-visible) or internal (agent-only). Reference: https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-issueidorkey-comment-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
The comment body text.
string
required
ID or key of the service request (e.g. SD-123).
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
boolean
Whether the comment is visible to the customer on the portal. Set to true for customer-visible, false for internal agent-only.Default: true.

Add extra properties to alert

Action ID: tools.jira_service_management.add_extra_properties Enrich an alert with additional contextual key-value properties. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-extra-properties-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
map[string, string]
required
Key-value pairs of extra properties to add.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Additional note to add.Default: null.
string | null
Display name of the request source.Default: null.
string | null
Display name of the request owner.Default: null.

Add responder to alert

Action ID: tools.jira_service_management.add_responder Assign a responder (user, team, or escalation) to an existing alert. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-responders-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
map[string, string]
required
Responder to add. Object with “type” and identifier. Example: {“type”: “team”, “id”: “team-id”} or {“type”: “user”, “id”: “user-id”} or {“type”: “escalation”, “id”: “escalation-id”}
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Additional note to add.Default: null.
string | null
Display name of the request source.Default: null.
string | null
Display name of the request owner.Default: null.

Add tags to alert

Action ID: tools.jira_service_management.add_tags Add tags to an alert for categorization and organization. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-tags-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
array[string]
required
Tags to add to the alert (max 20, each max 50 chars).
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Additional note to add.Default: null.
string | null
Display name of the request source.Default: null.
string | null
Display name of the request owner.Default: null.

Assign alert

Action ID: tools.jira_service_management.assign_alert Assign an alert to a user or group for responsibility. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-assign-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
map[string, string]
required
Owner to assign. Object with “type” and identifier. Example: {“type”: “user”, “id”: “user-id”} or {“type”: “user”, “username”: “john@example.com”}
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Additional note to add.Default: null.
string | null
Display name of the request source.Default: null.
string | null
Display name of the request owner.Default: null.

Close alert

Action ID: tools.jira_service_management.close_alert Close an alert, indicating the issue has been resolved. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-close-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Additional note to add.Default: null.
string | null
Display name of the request source.Default: null.
string | null
Display name of the request owner.Default: null.

Create alert

Action ID: tools.jira_service_management.create_alert Create a new alert. The request is processed asynchronously; use the returned request ID with get_request_status to track it. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Alert message (limited to 130 characters).
array[string] | null
Custom actions available for the alert (max 10, each max 50 chars).Default: null.
string | null
Client-defined unique identifier for the alert, used for deduplication. Maximum 512 characters.Default: null.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Detailed description of the alert (up to 15,000 characters).Default: null.
map[string, string] | null
Key-value pairs of additional properties (max 8000 chars total).Default: null.
string | null
Entity field of the alert, generally for domain of the alert (max 512 chars).Default: null.
string | null
Additional note to add when creating the alert (max 25,000 chars).Default: null.
string | null
Priority level (P1, P2, P3, P4, P5). Default is P3.Default: null.
array[object] | null
List of responders. Each responder is an object with “type” and an identifier. Example: [{“type”: “team”, “id”: “team-id”}, {“type”: “user”, “id”: “user-id”}]Default: null.
string | null
Source field of the alert (max 100 chars).Default: null.
array[string] | null
Tags for the alert (max 20, each max 50 chars).Default: null.
array[object] | null
Teams and users the alert will be visible to without sending notifications. Example: [{“type”: “team”, “id”: “team-id”}]Default: null.

Create heartbeat

Action ID: tools.jira_service_management.create_heartbeat Create a heartbeat monitor for a team. When the heartbeat stops receiving pings within its interval, Jira Service Management raises an alert. Heartbeat names must be unique within the team. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-heartbeats/#api-api-cloudid-v1-teams-teamid-heartbeats-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

integer
required
Number of interval units before the heartbeat expires and an alert is raised.
string
required
Unit of the interval. One of “minutes”, “hours”, or “days”.
string
required
Unique name of the heartbeat within the team.
string
required
Identifier of the team that owns the heartbeat.
string | null
Message of the alert raised when the heartbeat expires.Default: null.
string | null
Priority (P1, P2, P3, P4, P5) of the alert raised when the heartbeat expires.Default: null.
array[string] | null
Tags applied to the alert raised when the heartbeat expires.Default: null.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Detailed description of the heartbeat.Default: null.
boolean | null
Whether the heartbeat is active. Defaults to true when omitted.Default: null.

Create service request

Action ID: tools.jira_service_management.create_service_request Create a customer service request in Jira Service Management. Unlike the standard Jira create issue API, this creates a proper service request with queue placement, SLA tracking, and customer visibility. Reference: https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
The ID of the request type. Use the get_request_types action to discover valid IDs for a service desk.
string
required
The ID of the service desk to create the request in.
string
required
Brief one-line summary of the service request.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Detailed description of the service request.Default: null.
string | null
Account ID of the customer to raise the request on behalf of. Requires the agent to have the “Add customers” permission.Default: null.
object
Additional field values for the request, keyed by Jira field ID. For example: { "customfield_10000": "New value", "priority": {"id": "3"} }Default: {}.
array[string]
List of account IDs to add as request participants. Requires the agent to have the “Add request participants” permission.Default: [].

Delete alert

Action ID: tools.jira_service_management.delete_alert Delete an alert by its unique identifier. Processed asynchronously. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-delete

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.

Delete alert note

Action ID: tools.jira_service_management.delete_alert_note Remove a specific note from an alert. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-alertid-notes-id-delete

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
string
required
Identifier of the note to delete.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.

Delete extra properties from alert

Action ID: tools.jira_service_management.delete_extra_properties Remove specified extra properties from an alert. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-extra-properties-delete

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
array[string]
required
List of extra property keys to remove.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Additional note to add.Default: null.
string | null
Display name of the request source.Default: null.
string | null
Display name of the request owner.Default: null.

Delete heartbeat

Action ID: tools.jira_service_management.delete_heartbeat Delete a heartbeat monitor from a team, identified by name. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-heartbeats/#api-api-cloudid-v1-teams-teamid-heartbeats-delete

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Name of the heartbeat to delete.
string
required
Identifier of the team that owns the heartbeat.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.

Delete tags from alert

Action ID: tools.jira_service_management.delete_tags Remove tags from an alert. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-tags-delete

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
array[string]
required
Tags to remove from the alert.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Additional note to add.Default: null.
string | null
Display name of the request source.Default: null.
string | null
Display name of the request owner.Default: null.

Escalate alert to next

Action ID: tools.jira_service_management.escalate_alert Trigger escalation policies for an alert, notifying additional users or teams. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-escalate-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
map[string, string]
required
Escalation target. Object with “id” or “name”. Example: {“id”: “escalation-id”} or {“name”: “escalation-name”}
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Additional note to add.Default: null.
string | null
Display name of the request source.Default: null.
string | null
Display name of the request owner.Default: null.

Execute custom action on alert

Action ID: tools.jira_service_management.execute_custom_action Execute a custom action on an alert, including integrations with external systems. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-action-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Name of the custom action to execute.
string
required
Identifier of the alert.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Additional note to add.Default: null.
string | null
Display name of the request source.Default: null.
string | null
Display name of the request owner.Default: null.

Get alert

Action ID: tools.jira_service_management.get_alert Retrieve comprehensive details of a specific alert by its ID. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-get

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.

Get alert by alias

Action ID: tools.jira_service_management.get_alert_by_alias Retrieve comprehensive details of a specific alert using its alias. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-alias-get

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Alias of the alert to retrieve.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.

Get alert request status

Action ID: tools.jira_service_management.get_request_status Track status and details of an asynchronous alert request. Alert creation, deletion, and action requests are processed asynchronously; use this endpoint to check their status. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-requests-id-get

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the request (returned in the original async response).
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.

Get customer request by id or key

Action ID: tools.jira_service_management.get_customer_request Get a customer service request from Jira Service Management by its ID or key. Returns the full details of the request including status, reporter, and request field values. Reference: https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-request/#api-rest-servicedeskapi-request-issueidorkey-get

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
ID or key of the customer request (e.g. SD-123).
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
array[string] | null
List of properties to expand in the response. Valid values include participant, status, sla, requestType, serviceDesk, attachment, action, comment, and comment.renderedBody.Default: null.

Get next on-call participants

Action ID: tools.jira_service_management.get_next_on_calls Retrieve who is on-call in the next rotation period for a schedule, optionally relative to a specific point in time. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-schedule-on-calls/#api-api-cloudid-v1-schedules-scheduleid-next-on-calls-get

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the schedule.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Point in time (ISO 8601) to query the next on-call responders relative to. Defaults to the current time when omitted.Default: null.
boolean | null
When true, returns a flattened list of on-call user IDs. When false, returns detailed participant objects.Default: null.

Get on-call participants

Action ID: tools.jira_service_management.get_on_calls Retrieve who is currently on-call for a schedule, optionally at a specific point in time. Set flat to true to return only user IDs, or false for detailed participant objects (users, teams, escalations). Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-schedule-on-calls/#api-api-cloudid-v1-schedules-scheduleid-on-calls-get

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the schedule.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Point in time (ISO 8601) to query on-call responders for. Defaults to the current time when omitted.Default: null.
boolean | null
When true, returns a flattened list of on-call user IDs. When false, returns detailed participant objects.Default: null.

Get request types

Action ID: tools.jira_service_management.get_request_types Get the request types for a service desk in Jira Service Management. Use this to discover valid request type IDs for creating service requests. Reference: https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk/#api-rest-servicedeskapi-servicedesk-servicedeskid-requesttype-get

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
The ID of the service desk.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
integer
Maximum number of request types to return.Default: 50.
integer
Starting index of the returned request types.Default: 0.

Get service desks

Action ID: tools.jira_service_management.get_service_desks Get a list of service desks in Jira Service Management. Reference: https://developer.atlassian.com/cloud/jira/service-desk/rest/api-group-servicedesk/#api-rest-servicedeskapi-servicedesk-get

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
integer
Maximum number of service desks to return.Default: 50.
integer
Starting index of the returned service desks.Default: 0.

List alert logs

Action ID: tools.jira_service_management.list_alert_logs Retrieve a paginated list of alert activity logs for audit purposes, including creation, acknowledgment, assignment, and other events. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-logs-get

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
string | null
Pagination cursor - key of the last record from the previous page.Default: null.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
integer | null
Maximum number of logs to retrieve.Default: null.

List alert notes

Action ID: tools.jira_service_management.list_alert_notes Retrieve a paginated list of notes for a specified alert. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-notes-get

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
string | null
Pagination cursor - key of the last record from the previous page.Default: null.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
integer | null
Maximum number of notes to retrieve.Default: null.

List alerts

Action ID: tools.jira_service_management.list_alerts Retrieve all alerts with pagination and filtering support. Returns up to 20,000 alerts. Use the query parameter for search filtering. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-get

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Starting date-time filter (ISO 8601).Default: null.
integer | null
Starting point within the collection of results.Default: null.
string | null
Sorting order of the result set (asc or desc).Default: null.
string | null
Search query to filter alerts.Default: null.
integer | null
Maximum number of items to return.Default: null.
string | null
Name of the field to sort results by.Default: null.
string | null
Ending date-time filter (ISO 8601).Default: null.

List heartbeats

Action ID: tools.jira_service_management.list_heartbeats Retrieve the heartbeats configured for a team. Use this to discover heartbeat names and inspect their status, interval, and last ping time. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-heartbeats/#api-api-cloudid-v1-teams-teamid-heartbeats-get

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the team that owns the heartbeats.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.

List schedules

Action ID: tools.jira_service_management.list_schedules Retrieve on-call schedules with pagination and search support. Use this to discover schedule IDs for the on-call lookups. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-schedules/#api-api-cloudid-v1-schedules-get

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Comma-separated fields to expand in the response (e.g. rotation).Default: null.
integer | null
Starting point within the collection of results.Default: null.
string | null
Search query to filter schedules.Default: null.
integer | null
Maximum number of items to return.Default: null.

Ping heartbeat

Action ID: tools.jira_service_management.ping_heartbeat Send a ping to a heartbeat to signal that the monitored system is alive. Each ping resets the heartbeat’s expiration timer, preventing the expiry alert. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-heartbeats/#api-api-cloudid-v1-teams-teamid-heartbeats-ping-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Name of the heartbeat to ping.
string
required
Identifier of the team that owns the heartbeat.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.

Snooze alert

Action ID: tools.jira_service_management.snooze_alert Temporarily silence an alert for a specified period, preventing notifications. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-snooze-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
string
required
Snooze end time in ISO 8601 format.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Additional note to add.Default: null.
string | null
Display name of the request source.Default: null.
string | null
Display name of the request owner.Default: null.

Unacknowledge alert

Action ID: tools.jira_service_management.unacknowledge_alert Set the acknowledged property to false, marking the alert status as open. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-unacknowledge-post

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Additional note to add.Default: null.
string | null
Display name of the request source.Default: null.
string | null
Display name of the request owner.Default: null.

Update alert description

Action ID: tools.jira_service_management.update_alert_description Update the description of an alert to provide current incident details. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-description-patch

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
string
required
New alert description (max 15,000 characters).
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.

Update alert message

Action ID: tools.jira_service_management.update_alert_message Update the message of an alert to keep it accurate and current. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-message-patch

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
string
required
New alert message (max 130 characters).
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.

Update alert note

Action ID: tools.jira_service_management.update_alert_note Modify a note associated with a specific alert. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-alertid-notes-id-patch

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
string
required
Updated note text.
string
required
Identifier of the note to update.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Display name of the request source.Default: null.
string | null
Display name of the request owner.Default: null.

Update alert priority

Action ID: tools.jira_service_management.update_alert_priority Modify the priority level of an alert for dynamic urgency control. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-alerts/#api-api-cloudid-v1-alerts-id-priority-patch

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Identifier of the alert.
string
required
New priority level (P1, P2, P3, P4, P5).
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.

Update heartbeat

Action ID: tools.jira_service_management.update_heartbeat Update the configuration of an existing heartbeat, identified by name. Only supplied fields are changed. The heartbeat name itself cannot be changed. Reference: https://developer.atlassian.com/cloud/jira/service-desk-ops/rest/v2/api-group-heartbeats/#api-api-cloudid-v1-teams-teamid-heartbeats-patch

Secrets

Required secrets:
  • atlassian_oauth: OAuth token ATLASSIAN_USER_TOKEN.

Input fields

string
required
Name of the heartbeat to update.
string
required
Identifier of the team that owns the heartbeat.
string | null
Message of the alert raised when the heartbeat expires.Default: null.
string | null
Priority (P1, P2, P3, P4, P5) of the alert raised when the heartbeat expires.Default: null.
array[string] | null
Tags applied to the alert raised when the heartbeat expires.Default: null.
string | null
Atlassian API URL for the Jira site (e.g. https://api.atlassian.com/ex/jira/{cloudId}).Default: null.
string | null
Detailed description of the heartbeat.Default: null.
boolean | null
Whether the heartbeat is active.Default: null.
integer | null
Number of interval units before the heartbeat expires and an alert is raised.Default: null.
string | null
Unit of the interval. One of “minutes”, “hours”, or “days”.Default: null.