---
title: "👤 Add, remove or override GitHub<>JIRA user identity mapping."
method: PATCH
path: "/settings/jira/identities"
tags: ["settings", "default"]
---

# 👤 Add, remove or override GitHub<>JIRA user identity mapping.

`PATCH /settings/jira/identities`

## Request

- Base URL: `{{ server_url }}/v1`
- URL: `{{ server_url }}/v1/settings/jira/identities`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/athenian/apis/title/docs/settings/jira/identities/patch.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- SetMappedJIRAIdentitiesRequest: Request body of `/settings/jira/identities`. Describes a patch to the GitHub<>JIRA identity mapping.
  - `account` integer, required: Account ID.
  - `changes` MappedJIRAIdentityChange[], required: Individual GitHub<>JIRA user mapping change.
    - `developer_id` string, required: User name which uniquely identifies any developer on any service provider. The format matches the profile URL without the protocol part.
    - `jira_name` string, nullable, required: Full name of the mapped JIRA user. `null` means the removal.

## Response `200`

List with the Github<>JIRA identity mapping.

- MappedJIRAIdentity[]: List of currently mapped GitHub<>JIRA users. Additionally, we include unmapped JIRA users to provide a complete list of them.
  - `developer_id` union, required
    - string: User name which uniquely identifies any developer on any service provider. The format matches the profile URL without the protocol part.
    - string, nullable
  - `developer_name` string, nullable, required: Full name of the mapped GitHub user.
  - `jira_name` string, required: Full name of the mapped JIRA user.
  - `confidence` number, float, required: Value from 0 to 1 indicating how similar are the users.

## Other responses

- `400`: Request is invalid.
- `403`: The user is not an admin of this account.
- `404`: The user or the account was not found.
- `422`: The JIRA installation does not exist.

---

[API](https://skmtc.dev/athenian/apis/title.md) - [All operations](https://skmtc.dev/athenian/apis/title/llms.txt) - [OpenAPI document](https://skmtc.dev/athenian/apis/title/revisions/110c9f7cffdd?raw)