Skip to content

Jira export

Creates a Jira Cloud issue via REST API (POST /rest/api/3/issue).

Prerequisites

  1. Atlassian account with access to the project
  2. API token for the bot user email
  3. Project key (e.g. ENG, SUPPORT)
  4. Public screenshot URL for image embeds — Storage

Configuration

ts
export default defineNuxtConfig({
  bugfreedback: {
    export: {
      provider: 'jira',
      baseUrl: 'https://your-org.atlassian.net',
      email: process.env.BUGFREEDBACK_JIRA_EMAIL || '',
      apiToken: process.env.BUGFREEDBACK_JIRA_API_TOKEN || '',
      projectKey: 'ENG',
      issueType: 'Bug', // optional, default Bug
    },
  },
})

Environment variables

VariablePurpose
BUGFREEDBACK_JIRA_BASE_URLe.g. https://your-org.atlassian.net
BUGFREEDBACK_JIRA_EMAILAtlassian account email
BUGFREEDBACK_JIRA_API_TOKENAPI token
BUGFREEDBACK_JIRA_PROJECT_KEYProject key

Issue content

  • Summary — feedback title
  • Description — Atlassian Document Format (ADF) with description, screenshot, reporter, metadata
  • ProjectprojectKey
  • Issue typeissueType (default Bug)

Returns { id, url } where id is the issue key (e.g. ENG-42) and url is the browse link.

Example

ts
export: {
  provider: 'jira',
  baseUrl: process.env.BUGFREEDBACK_JIRA_BASE_URL!,
  email: 'bot@example.com',
  apiToken: process.env.BUGFREEDBACK_JIRA_API_TOKEN!,
  projectKey: 'SUPPORT',
  issueType: 'Task',
}

Released under the MIT License.