Bitbucket modules
Common modules
Compass modules
Confluence modules
Jira modules
Jira Service Management modules

This section describes a Forge preview feature. Preview features are deemed stable; however, they remain under active development and may be subject to shorter deprecation windows. Preview features are suitable for early adopters in production environments.

We release preview features so partners and developers can study, test, and integrate them prior to General Availability (GA). For more information, see Forge release phases: EAP, Preview, and GA.

Jira workflow post function (preview)

The jira:workflowPostFunction module creates a workflow post function that can be configured on workflow transitions in company-managed projects ( see: Advanced workflow configuration).

Post functions carry out any additional processing required after a Jira workflow transition is executed, such as:

  • updating an issue's fields
  • adding a comment to an issue

A function must be declared in the manifest and configured for a given post function module. It is then invoked after every transition to which the post function has been added, with the post function event as an argument. If multiple post functions are added to a transition, the execution order is not guaranteed.

Lambda function

Whenever an issue is transitioned and an app-registered Forge workflow post function is assigned to the transition, the function declared in the manifest is executed.

A function must be declared in the manifest and configured for a given post function. It is then invoked after every transition to which the post function has been added. When the function is invoked, an argument is passed to it with the following information about the transition.

Retries for post functions work in the same way as product event retries. You can request a retry for a function invocation by returning an InvocationError object, defined in the @forge/events package.


The payload is the same payload included in post function event. Due to the data sent to the function from Jira, it is necessary to include OAuth scopes in the app manifest: read:jira-work and manage:jira-configuration.

Fetching additional data

You can fetch additional data not included in the argument passed to the lambda function using the Product Fetch API from the @forge/api package.

In the jira:workflowPostFunction module, calls to an Atlassian API must be made as the app developer by using api.asApp() method.

Sample resources:

Adding post function configuration with custom UI

Workflow post function behavior often requires some configuration. For example, you may want to react to a state transition only if the issue has a particular label, and you want the project administrator to configure that label. For this purpose, three additional properties in the manifest allow you to declare custom UI resources that will show:

  • the form that is shown when a post function is first created
  • the form that is shown when a post function is edited
  • the read-only view or summary of the configuration

The create and edit pages should present a form with configuration items relevant to the post function. In order to persist this information in Jira, the page needs to use the workflowRules API.

Note: the maximum size of post function configuration is 100 kB.

The config context variable is stored under the extension.postFunctionConfig key in the context object returned from the getContext API in the custom UI bridge.

Post function configuration is also included in the post function event.


To create a post function that displays a custom UI, declare it in the manifest as follows:

  - key: my-forge-workflow-post-function
    name: Jira workflow post function example
    description: This post function will be executed after issue transition.
    function: my-postfunction
      resource: edit-resource
      resource: create-resource
      resource: view-resource
  - key: create-resource
    path: static/create/build
  - key: edit-resource
    path: static/edit/build
  - key: view-resource
    path: static/view/build
  - key: my-postfunction
    handler: index.postfunction
    - manage:jira-configuration
    - read:jira-work

To get product context in the create, edit, and view resources defined in the manifest, use the view.getContext function.

import { view } from '@forge/bridge';

function App() {
    const [context, setContext] = useState();
    const [config, setConfig] = useState();

    useEffect(() => {
        view.getContext().then(ctx => {
    }, []);

To save user input to the config context variable, pass the callback function returning stringified JSON to the workflowRules.onConfigure function.

import { workflowRules } from '@forge/jira-bridge';

const onConfigureFn = async () => {
    var config = {
        'key': 'value'

    return JSON.stringify(config);

// calling onConfigure from an async function
try {
    await workflowRules.onConfigure(onConfigureFn);
} catch (e) {
    // Handle the error.

// calling onConfigure from a non-async function
    .catch(e => {
        // Handle the error.

To implement the actual post function logic in the src/index.js file, declare the function that will be invoked:

import api, { route } from '@forge/api';

export const postfunction = async event => {
    console.log(`Running post function for issue ${event.issue.key}`);

    if (event.comment) {
        const response = await api
        const commentData = await response.json();
        console.log('Comment data', commentData);
    } else {
        console.log('Comment absent');

    if (event.changelog) {
        const response = await api
                    method: 'POST',
                    body: JSON.stringify({'changelogIds': [parseInt(]})
        const changelogData = await response.json();
        console.log('Changelog data', changelogData);
    } else {
        console.log('Changelog absent');





A key for the module, which other modules can refer to. Must be unique within the manifest.

Regex: ^[a-zA-Z0-9_-]+$

namestringYesThe name of the post function displayed in the workflow configuration.
descriptionstringYesThe description of the post function displayed when adding the post function to a transition.
functionstringRequired if using UI Kit 1.A reference to the function module that defines the module. Only used in UI Kit 1.
create{ resource: string }No A reference to the static resources entry that allows you to configure the post function on creation.

See Resources for more details.

edit{ resource: string }No A reference to the static resources entry that allows to edit the post function.

See Resources for more details.

view{ resource: string }No A reference to the static resources entry that allows to view the summary of the post function configuration.

See Resources for more details.

Known issues

Rate this page: