Cross-Provider Workflow

Jira Issue to Confluence Documentation Page

Version 1.0.0

Create a Jira issue, then publish a linked Confluence page documenting it.

1 workflow 2 source APIs 2 providers
View Spec View on GitHub ArazzoWorkflowsCross-Provider

Providers Orchestrated

jira confluence

Workflows

issue-to-confluence
Create a Jira issue, then publish a Confluence documentation page.
Creates a Jira issue and publishes a Confluence page in the target space that documents the new issue and its summary.
2 steps inputs: confluenceSpaceId, description, jiraProjectKey, pageBody, summary outputs: issueKey, pageId
1
create-issue
$sourceDescriptions.jiraApi.createIssue
Create a Jira issue for the tracked problem.
2
create-page
$sourceDescriptions.confluenceApi.createPage
Publish a Confluence page documenting the Jira issue.

Source API Descriptions

Arazzo Workflow Specification

itsm-jira-issue-to-confluence-page.yml Raw ↑
arazzo: 1.0.1
info:
  title: Jira Issue to Confluence Documentation Page
  summary: Create a Jira issue, then publish a linked Confluence page documenting it.
  description: >-
    A cross-provider ITSM workflow that opens a Jira issue for a tracked problem
    and publishes a matching Confluence page that documents the issue for the
    wider team. Demonstrates orchestrating an issue tracker with a knowledge base
    provider in a single Arazzo workflow.
  version: 1.0.0
sourceDescriptions:
  - name: jiraApi
    url: https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-cloud-platform-rest-api-openapi.yml
    type: openapi
  - name: confluenceApi
    url: https://raw.githubusercontent.com/api-evangelist/confluence/refs/heads/main/openapi/confluence-cloud-v2.yml
    type: openapi
workflows:
  - workflowId: issue-to-confluence
    summary: Create a Jira issue, then publish a Confluence documentation page.
    description: >-
      Creates a Jira issue and publishes a Confluence page in the target space
      that documents the new issue and its summary.
    inputs:
      type: object
      properties:
        jiraProjectKey:
          type: string
        summary:
          type: string
        description:
          type: string
        confluenceSpaceId:
          type: string
        pageBody:
          type: string
    steps:
      - stepId: create-issue
        description: Create a Jira issue for the tracked problem.
        operationId: $sourceDescriptions.jiraApi.createIssue
        requestBody:
          contentType: application/json
          payload:
            fields:
              project:
                key: $inputs.jiraProjectKey
              summary: $inputs.summary
              description: $inputs.description
              issuetype:
                name: Task
        successCriteria:
          - condition: $statusCode == 201
        outputs:
          issueKey: $response.body#/key
          issueId: $response.body#/id
      - stepId: create-page
        description: Publish a Confluence page documenting the Jira issue.
        operationId: $sourceDescriptions.confluenceApi.createPage
        requestBody:
          contentType: application/json
          payload:
            spaceId: $inputs.confluenceSpaceId
            status: current
            title: $inputs.summary
            body:
              representation: storage
              value: $inputs.pageBody
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          pageId: $response.body#/id
    outputs:
      issueKey: $steps.create-issue.outputs.issueKey
      pageId: $steps.create-page.outputs.pageId