Skip to content

docs(jira): document browser OAuth (PKCE) login#13

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/3ba0cdfa
Open

docs(jira): document browser OAuth (PKCE) login#13
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/3ba0cdfa

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 9, 2026

Copy link
Copy Markdown

Summary

Rewrite the Jira integration guide to lead with the new one-command browser OAuth flow, and surface the supporting CLI command and environment variable in the reference pages.

Changes

  • guides/jira.mdx: lead with meridian oauth-login jira (Authorization Code + PKCE). Document the token store at ~/.meridian/oauth/jira.json (mode 0600, auto-refresh with rotating refresh tokens), the requested scopes (read:jira-work, write:jira-work, read:jira-user, offline_access), the resolver order (OAuth wins when the token store exists, basic auth as fallback), and the JIRA_OAUTH_CLIENT_ID override for self-hosted Atlassian apps. Keep the API-token path as a documented fallback for org-blocked installs.
  • reference/cli.mdx: add accordions for meridian oauth-login jira and meridian tasks-sync.
  • reference/environment-variables.mdx: clarify that Jira is configured when either the OAuth token store or all three static creds are present; add JIRA_OAUTH_CLIENT_ID.

Context

Source PRs: Meridiona/meridian#203 (OAuth implementation) and Meridiona/meridian#213 (installer integration + maintainer runbook). Linear OAuth is held for a follow-up.

@mintlify

mintlify Bot commented Jun 9, 2026

Copy link
Copy Markdown
Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
meridiona 🟢 Ready View Preview Jun 9, 2026, 7:13 AM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants