OpenAPI Integration for Jira Conversational Agents: Authentication Issue

[EBastiani]

Hi everyone,

I'm developing a conversational agent and working on integrating it with Jira to open tickets. My schema appears to be correct, as the conversational agent is generating the JSON payload as expected. However, I'm unable to make the request successfully.

I suspect the issue might be related to authentication. I've tried using both Bearer Token authentication and OAuth, but neither approach seems to work. I successfully tested the integration in Postman using Basic Auth (username and API Key), but the Conversational Agent fails to make the API call.

Here’s the schema I’m using:

{
  "openapi": "3.0.0",
  "info": {
    "title": "Jira API - Create Issue",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://jira-test.atlassian.net/rest/api/3"
    }
  ],
  "paths": {
    "/issue": {
      "post": {
        "summary": "Create a Jira Issue",
        "operationId": "createIssue",
        "requestBody": {
          "description": "Details of the issue to be created",
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateIssueRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Issue successfully created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateIssueResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request. The payload is invalid."
          },
          "401": {
            "description": "Unauthorized. API key or authentication is missing/invalid."
          },
          "500": {
            "description": "Server error. Something went wrong on Jira's side."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "CreateIssueRequest": {
        "type": "object",
        "properties": {
          "fields": {
            "type": "object",
            "properties": {
              "project": {
                "type": "object",
                "properties": {
                  "key": {
                    "type": "string",
                    "example": "PROJ"
                  }
                },
                "required": [
                  "key"
                ]
              },
              "summary": {
                "type": "string",
                "example": "ADD SUMMARY HERE"
              },
              "issuetype": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "example": "Task"
                  }
                },
                "required": [
                  "name"
                ]
              }
            },
            "required": [
              "project",
              "summary",
              "issuetype"
            ]
          }
        },
        "required": [
          "fields"
        ]
      },
      "CreateIssueResponse": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "10001"
          },
          "key": {
            "type": "string",
            "example": "PROJ-1"
          },
          "self": {
            "type": "string",
            "example": "https://jira-test.atlassian.net/rest/api/3/issue/10001"
          }
        }
      }
    }
  }
}

And here’s a sample payload generated by the model:

{
    "fields": {
        "project": 
        {
            "key": "PROJ"
        },
        "summary": "ADD SUMMARY HERE",
        "issuetype": {
            "name": "Task"
        }
    }
}

Does anyone have any tips on how to successfully open tickets in Jira via this integration? Also, which authentication method is recommended for this use case?

Thanks in advance for your help!