---
title: "Check Jira Connection"
method: POST
path: "/workspaces/notifications/jira/check-connection"
tags: ["Workspaces - Notifications Jira helper"]
---

# Check Jira Connection

`POST /workspaces/notifications/jira/check-connection`

## Request body

- JiraNotification
  - `url` string
  - `connectionType` 'JIRA_CLOUD' | 'JIRA_DATA_CENTER_BASIC' | 'JIRA_DATA_CENTER_ACCESS_TOKEN', nullable
  - `apiKey` EncryptedText
    - `value` string
    - `type` 'PLAIN' | 'ENCRYPTED'
  - `email` string, nullable
  - `boardId` string
  - `issueNameFilter` string, nullable
  - `projectId` string
  - `statusId` string
  - `failTransitionId` string, nullable
  - `passTransitionId` string, nullable
  - `errorTransitionId` string, nullable

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `429` — Too Many Requests

## Changes

- **2026-09-26** `65e661618b8f` — 1 info
  - api operation id `w` removed and replaced with `r`
- **2026-09-15** `4da8c9536717` — 1 info
  - api operation id `F` removed and replaced with `w`
- **2026-09-15** `e2458537595b` — 1 info
  - api operation id `W` removed and replaced with `F`
- **2026-09-11** `2e438cb3181d` — 1 info
  - api operation id `X` removed and replaced with `W`
- **2026-09-07** `50527361f800` — 1 info
  - api operation id `O_1` removed and replaced with `X`

[Full history](https://skmtc.dev/octoperf/apis/octoperf-api/changes/workspaces/notifications/jira/check-connection/post.md)

---

[API](https://skmtc.dev/octoperf/apis/octoperf-api.md) · [All operations](https://skmtc.dev/octoperf/apis/octoperf-api/llms.txt) · [OpenAPI document](https://skmtc.dev/octoperf/apis/octoperf-api/revisions/65e661618b8f?raw)