---
title: "Creates or updates a Jira MCP integration credential"
method: PUT
path: "/v1/integrations/jira-mcp/{id}/api-key"
tags: ["Jira MCP Integration"]
---

# Creates or updates a Jira MCP integration credential

`PUT /v1/integrations/jira-mcp/{id}/api-key`

## Request

- Base URL: `https://docs.grepr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.grepr.ai/v1/integrations/jira-mcp/{id}/api-key`
- Auth: one of:
  - API key in header `GREPR-API-KEY`
  - OpenID Connect (`https://grepr-prod.us.auth0.com/.well-known/openid-configuration`)

Creates the Atlassian service account API token for a Jira MCP integration if it doesn't exist and updates it otherwise. Unless validateKeysOnSave is false, the credential is checked against the Atlassian MCP server first and is not stored if Atlassian refuses it or it gives no Jira tools.

## Path parameters

- `id` string, required

## Request body

- SecretApi: Secret wrapper for API responses
  - `secret` string, required: The secret value

## Response `204`

Credential upserted successfully.

## Other responses

- `400`: Atlassian refused the credential, could not be reached, or gave no Jira tools.
- `401`: Unauthorized
- `404`: Integration not found.

---

[API](https://skmtc.dev/grepr/apis/grepr-api.md) - [All operations](https://skmtc.dev/grepr/apis/grepr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grepr/apis/grepr-api/revisions/2a5ce03a0bf0?raw)