Provided free and as is, without warranty of any kind — including merchantability, fitness for a particular purpose, and the accuracy or completeness of any result. See the licence. You are responsible for checking what this produces before relying on it.

Opsgenie

Create, close, get, and list Opsgenie alerts directly from InTouch using the official Alert API.

Base URL: https://api.opsgenie.com (set eu: true for https://api.eu.opsgenie.com)
Auth: Authorization: GenieKey <apiKey> (handled for you)
Library: Python standard library only — no external dependencies

Operations

operation	What it does	HTTP call
`create`	Raise a new alert	`POST /v2/alerts`
`close`	Close an existing alert	`POST /v2/alerts/{identifier}/close`
`get`	Fetch one alert's full details	`GET /v2/alerts/{identifier}`
`list`	Search / list alerts	`GET /v2/alerts`

Inputs

Input	Used by	Notes
`apiKey`	all	Required. Opsgenie API integration key.
`operation`	all	Required. `create`, `close`, `get`, or `list`.
`eu`	all	`true` to target the EU region base URL.
`message`	create	Alert title (required, truncated to 130 chars).
`alias`	create	De-duplication alias.
`priority`	create	`P1`–`P5`.
`tags`	create	Comma-separated tags.
`identifier`	close, get	Alert id / tiny id / alias.
`identifierType`	close, get	`id` (default), `tiny`, or `alias`.
`note`	close	Optional note recorded on close.
`query`	list	Opsgenie search query, e.g. `status: open`.
`limit`	list	1–100, default 20.

Outputs

result — the raw JSON response body from Opsgenie (as a string).
status — the HTTP status code (202 for create/close, 200 for get/list).

Getting an API key

In Opsgenie go to Settings → Integrations.
Add an API integration (or open an existing one).
Copy its API Key. That value is the apiKey input.

The key is sent as Authorization: GenieKey <apiKey>.

Examples

Create a P2 alert

operation: create
apiKey:    <your-api-key>
message:   Database connection pool exhausted
priority:  P2
tags:      database,prod
alias:     db-pool-exhausted

Returns HTTP 202 and a request-id payload in result.

Close that alert by its alias, with a note

operation:      close
apiKey:         <your-api-key>
identifier:     db-pool-exhausted
identifierType: alias
note:           Pool size increased; recovered.

List the open alerts

operation: list
apiKey:    <your-api-key>
query:     status: open
limit:     10

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

error
result
status

Input Properties

Every property this tool accepts, from its own tool.iml.

Property	Type	Required	Default	Description
`apiKey`	string	yes	—	DEPRECATED — bind an API Key credential to the task with `credentialName` instead. A key pasted here is stored in the workflow definition in clear and appears in every export of it. Still honoured for workflows built before the change.
`operation`	string	yes	—	One of: create, close, get, list
`eu`	string	no	—	Set to 'true' to use the EU base URL (https://api.eu.opsgenie.com); otherwise the US base URL is used.
`message`	string	no	—	create: the alert message/title (required, max 130 chars).
`alias`	string	no	—	create: client-defined alert alias for de-duplication (optional).
`priority`	string	no	—	create: alert priority P1-P5 (optional, e.g. P3).
`tags`	string	no	—	create: comma-separated alert tags (optional).
`identifier`	string	no	—	close/get: alert identifier value (id, tiny id, or alias).
`identifierType`	string	no	`id`	close/get: type of identifier — one of id, tiny, alias (default id).
`note`	string	no	—	close: optional note added to the alert when closing.
`query`	string	no	—	list: Opsgenie search query (e.g. 'status: open') (optional).
`limit`	string	no	`20`	list: max alerts to return, 1-100 (default 20).