> ## Documentation Index > Fetch the complete documentation index at: https://docs.tracecat.com/llms.txt > Use this file to discover all available pages before exploring further. # Jira Service Management > Reference for the Tracecat Jira Service Management integration: registered actions, required secrets, expected inputs, and example workflow usage. ## 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](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 **alert\_id** `string` *required* Identifier of the alert. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **note** `string | null` Additional note to add. Default: `null`. **source** `string | null` Display name of the request source. Default: `null`. **user** `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](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 **alert\_id** `string` *required* Identifier of the alert. **note** `string` *required* Note text to add to the alert (max 25,000 chars). **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **source** `string | null` Display name of the request source. Default: `null`. **user** `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](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 **comment** `string` *required* The comment body text. **issue\_id\_or\_key** `string` *required* ID or key of the service request (e.g. SD-123). **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **public** `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](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 **alert\_id** `string` *required* Identifier of the alert. **details** `map[string, string]` *required* Key-value pairs of extra properties to add. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **note** `string | null` Additional note to add. Default: `null`. **source** `string | null` Display name of the request source. Default: `null`. **user** `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](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 **alert\_id** `string` *required* Identifier of the alert. **responder** `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"} **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **note** `string | null` Additional note to add. Default: `null`. **source** `string | null` Display name of the request source. Default: `null`. **user** `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](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 **alert\_id** `string` *required* Identifier of the alert. **tags** `array[string]` *required* Tags to add to the alert (max 20, each max 50 chars). **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **note** `string | null` Additional note to add. Default: `null`. **source** `string | null` Display name of the request source. Default: `null`. **user** `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](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 **alert\_id** `string` *required* Identifier of the alert. **owner** `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](mailto:john@example.com)"} **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **note** `string | null` Additional note to add. Default: `null`. **source** `string | null` Display name of the request source. Default: `null`. **user** `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](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 **alert\_id** `string` *required* Identifier of the alert. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **note** `string | null` Additional note to add. Default: `null`. **source** `string | null` Display name of the request source. Default: `null`. **user** `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](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 **message** `string` *required* Alert message (limited to 130 characters). **actions** `array[string] | null` Custom actions available for the alert (max 10, each max 50 chars). Default: `null`. **alias** `string | null` Client-defined unique identifier for the alert, used for deduplication. Maximum 512 characters. Default: `null`. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **description** `string | null` Detailed description of the alert (up to 15,000 characters). Default: `null`. **details** `map[string, string] | null` Key-value pairs of additional properties (max 8000 chars total). Default: `null`. **entity** `string | null` Entity field of the alert, generally for domain of the alert (max 512 chars). Default: `null`. **note** `string | null` Additional note to add when creating the alert (max 25,000 chars). Default: `null`. **priority** `string | null` Priority level (P1, P2, P3, P4, P5). Default is P3. Default: `null`. **responders** `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`. **source** `string | null` Source field of the alert (max 100 chars). Default: `null`. **tags** `array[string] | null` Tags for the alert (max 20, each max 50 chars). Default: `null`. **visible\_to** `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](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 **interval** `integer` *required* Number of interval units before the heartbeat expires and an alert is raised. **interval\_unit** `string` *required* Unit of the interval. One of "minutes", "hours", or "days". **name** `string` *required* Unique name of the heartbeat within the team. **team\_id** `string` *required* Identifier of the team that owns the heartbeat. **alert\_message** `string | null` Message of the alert raised when the heartbeat expires. Default: `null`. **alert\_priority** `string | null` Priority (P1, P2, P3, P4, P5) of the alert raised when the heartbeat expires. Default: `null`. **alert\_tags** `array[string] | null` Tags applied to the alert raised when the heartbeat expires. Default: `null`. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **description** `string | null` Detailed description of the heartbeat. Default: `null`. **enabled** `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](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 **request\_type\_id** `string` *required* The ID of the request type. Use the get\_request\_types action to discover valid IDs for a service desk. **service\_desk\_id** `string` *required* The ID of the service desk to create the request in. **summary** `string` *required* Brief one-line summary of the service request. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **description** `string | null` Detailed description of the service request. Default: `null`. **raise\_on\_behalf\_of** `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`. **request\_field\_values** `object` Additional field values for the request, keyed by Jira field ID. For example: `{ "customfield_10000": "New value", "priority": {"id": "3"} }` Default: `{}`. **request\_participants** `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](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 **alert\_id** `string` *required* Identifier of the alert. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](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](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 **alert\_id** `string` *required* Identifier of the alert. **note\_id** `string` *required* Identifier of the note to delete. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](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](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 **alert\_id** `string` *required* Identifier of the alert. **keys** `array[string]` *required* List of extra property keys to remove. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **note** `string | null` Additional note to add. Default: `null`. **source** `string | null` Display name of the request source. Default: `null`. **user** `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](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 **name** `string` *required* Name of the heartbeat to delete. **team\_id** `string` *required* Identifier of the team that owns the heartbeat. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](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](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 **alert\_id** `string` *required* Identifier of the alert. **tags** `array[string]` *required* Tags to remove from the alert. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **note** `string | null` Additional note to add. Default: `null`. **source** `string | null` Display name of the request source. Default: `null`. **user** `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](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 **alert\_id** `string` *required* Identifier of the alert. **escalation** `map[string, string]` *required* Escalation target. Object with "id" or "name". Example: \{"id": "escalation-id"} or \{"name": "escalation-name"} **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **note** `string | null` Additional note to add. Default: `null`. **source** `string | null` Display name of the request source. Default: `null`. **user** `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](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 **action\_name** `string` *required* Name of the custom action to execute. **alert\_id** `string` *required* Identifier of the alert. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **note** `string | null` Additional note to add. Default: `null`. **source** `string | null` Display name of the request source. Default: `null`. **user** `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](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 **alert\_id** `string` *required* Identifier of the alert. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](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](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 **alias** `string` *required* Alias of the alert to retrieve. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](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](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 **request\_id** `string` *required* Identifier of the request (returned in the original async response). **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](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](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 **issue\_id\_or\_key** `string` *required* ID or key of the customer request (e.g. SD-123). **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **expand** `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](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 **schedule\_id** `string` *required* Identifier of the schedule. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **date** `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`. **flat** `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](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 **schedule\_id** `string` *required* Identifier of the schedule. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **date** `string | null` Point in time (ISO 8601) to query on-call responders for. Defaults to the current time when omitted. Default: `null`. **flat** `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](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 **service\_desk\_id** `string` *required* The ID of the service desk. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **limit** `integer` Maximum number of request types to return. Default: `50`. **start** `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](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 **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **limit** `integer` Maximum number of service desks to return. Default: `50`. **start** `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](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 **alert\_id** `string` *required* Identifier of the alert. **after** `string | null` Pagination cursor - key of the last record from the previous page. Default: `null`. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **size** `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](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 **alert\_id** `string` *required* Identifier of the alert. **after** `string | null` Pagination cursor - key of the last record from the previous page. Default: `null`. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **size** `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](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 **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **from\_date** `string | null` Starting date-time filter (ISO 8601). Default: `null`. **offset** `integer | null` Starting point within the collection of results. Default: `null`. **order** `string | null` Sorting order of the result set (asc or desc). Default: `null`. **query** `string | null` Search query to filter alerts. Default: `null`. **size** `integer | null` Maximum number of items to return. Default: `null`. **sort** `string | null` Name of the field to sort results by. Default: `null`. **to\_date** `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](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 **team\_id** `string` *required* Identifier of the team that owns the heartbeats. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](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](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 **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **expand** `string | null` Comma-separated fields to expand in the response (e.g. rotation). Default: `null`. **offset** `integer | null` Starting point within the collection of results. Default: `null`. **query** `string | null` Search query to filter schedules. Default: `null`. **size** `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](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 **name** `string` *required* Name of the heartbeat to ping. **team\_id** `string` *required* Identifier of the team that owns the heartbeat. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](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](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 **alert\_id** `string` *required* Identifier of the alert. **end\_time** `string` *required* Snooze end time in ISO 8601 format. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **note** `string | null` Additional note to add. Default: `null`. **source** `string | null` Display name of the request source. Default: `null`. **user** `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](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 **alert\_id** `string` *required* Identifier of the alert. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **note** `string | null` Additional note to add. Default: `null`. **source** `string | null` Display name of the request source. Default: `null`. **user** `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](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 **alert\_id** `string` *required* Identifier of the alert. **description** `string` *required* New alert description (max 15,000 characters). **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](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](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 **alert\_id** `string` *required* Identifier of the alert. **message** `string` *required* New alert message (max 130 characters). **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](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](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 **alert\_id** `string` *required* Identifier of the alert. **note** `string` *required* Updated note text. **note\_id** `string` *required* Identifier of the note to update. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **source** `string | null` Display name of the request source. Default: `null`. **user** `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](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 **alert\_id** `string` *required* Identifier of the alert. **priority** `string` *required* New priority level (P1, P2, P3, P4, P5). **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](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](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 **name** `string` *required* Name of the heartbeat to update. **team\_id** `string` *required* Identifier of the team that owns the heartbeat. **alert\_message** `string | null` Message of the alert raised when the heartbeat expires. Default: `null`. **alert\_priority** `string | null` Priority (P1, P2, P3, P4, P5) of the alert raised when the heartbeat expires. Default: `null`. **alert\_tags** `array[string] | null` Tags applied to the alert raised when the heartbeat expires. Default: `null`. **base\_url** `string | null` Atlassian API URL for the Jira site (e.g. [https://api.atlassian.com/ex/jira/\{cloudId\}](https://api.atlassian.com/ex/jira/\{cloudId\});). Default: `null`. **description** `string | null` Detailed description of the heartbeat. Default: `null`. **enabled** `boolean | null` Whether the heartbeat is active. Default: `null`. **interval** `integer | null` Number of interval units before the heartbeat expires and an alert is raised. Default: `null`. **interval\_unit** `string | null` Unit of the interval. One of "minutes", "hours", or "days". Default: `null`. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.