GPTAssistantJiraAction.yml

openapi: 3.1.0
info:
  title: Jira Universal Project Data Export
  version: 2.1.0
  description: Fetches Jira issues, project metadata, field definitions, statuses, and current sprint data dynamically.

servers:
  - url: https://phase2tech.atlassian.net

paths:
  /rest/api/3/project/{projectKey}:
    get:
      operationId: fetchProjectMetadata
      summary: Fetch metadata for a Jira project
      parameters:
        - name: projectKey
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Project metadata

  /rest/api/3/field:
    get:
      operationId: fetchFieldDefinitions
      summary: Fetch all Jira fields to resolve custom field keys
      responses:
        '200':
          description: Field metadata

  /rest/api/3/project/{projectKey}/statuses:
    get:
      operationId: fetchProjectStatuses
      summary: Fetch project-specific status mappings
      parameters:
        - name: projectKey
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Project statuses

  /rest/api/3/search:
    get:
      operationId: fetchJiraIssues
      summary: Fetch issues for a Jira project with dynamic fields
      parameters:
        - name: jql
          in: query
          required: true
          schema:
            type: string
        - name: fields
          in: query
          required: false
          schema:
            type: string
        - name: startAt
          in: query
          required: false
          schema:
            type: integer
            default: 0
        - name: maxResults
          in: query
          required: false
          schema:
            type: integer
            default: 50
      responses:
        '200':
          description: Jira issues matching the query

  /rest/agile/1.0/board:
    get:
      operationId: fetchBoardsForProject
      summary: Fetch Jira boards associated with a project
      parameters:
        - name: projectKeyOrId
          in: query
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Boards for the given project

  /rest/agile/1.0/board/{boardId}/sprint:
    get:
      operationId: getCurrentSprintForProject
      summary: Fetch the current sprint from the board associated with a project
      parameters:
        - name: boardId
          in: path
          required: true
          schema:
            type: integer
        - name: state
          in: query
          required: false
          schema:
            type: string
            default: active
      responses:
        '200':
          description: List of active sprints on the board

Instructions.md

1. Add this to the GPT's instruction.

Jira Notes:
- projectKey: ADBUILD
- Other instructions can follow that relate to Jira.

2. Generate a password hash using your email address and Jira API key.

• In Terminal, enter:

  echo -n 'EMAIL_ADDRESS:JIRA_API_KEY' | base64 | pbcopy

  This will copy the password hash into your clipboard.

3. Create a new Action. Paste the contents of GPTAssistantJiraAction.yml (above) in the Schema field.

4. Open the Authentication modal and select:

• Auth Type: Basic
• In the API Key field, type:

  Basic PASSWORD_HASH
  

• Save your changes.