---
title: "Atlassian's authorize page for the 50heads Jira app, with a signed state that works once, for 10 minutes."
method: GET
path: "/v1/apps/jira/install"
tags: ["apps"]
---

# Atlassian's authorize page for the 50heads Jira app, with a signed state that works once, for 10 minutes.

`GET /v1/apps/jira/install`

## Request

- Base URL: `https://api.50heads.com`
- URL: `https://api.50heads.com/v1/apps/jira/install`
- Auth: HTTP bearer

Portal session only; in a team, the owner or an admin. Atlassian sends the person back to the portal's Integrations page with `installed=jira`, or `error=` denied, expired, already_installed or failed. One Jira site per install. 503 `jira_not_configured` when the Atlassian app is not set up; 404 while the Jira app is off on this server.

## Response `200`

OK

- AppsJiraInstallResponse
  - `url` string, required

## Other responses

- `401`: No key or token, or it expired or was revoked.
- `403`: The key or token lacks the scope (`insufficient_scope`), or the action is not allowed.
- `429`: Too many requests; wait for Retry-After.

---

[API](https://skmtc.dev/50heads/apis/50heads-api.md) · [All operations](https://skmtc.dev/50heads/apis/50heads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/50heads/apis/50heads-api/revisions/20175e8b00e3?raw)