Troubleshooting

Owerview

This document helps you troubleshoot the most common issues you may encounter while installing or deploying the app to Jira.

Some problems cannot be fixed automatically by our agent because they depend on:

• your Atlassian account settings (e.g., API tokens),

• Jira permissions,

• or Atlassian Forge availability.

Here you’ll find clear steps to resolve these issues manually and continue the setup process.

API Token Issues

This type of error occurs when an invalid or expired API token is provided. If the token is invalid or expired, the app cannot be registered, installed or deployed.

How to fix it?

The API token is used only during the app installation and deployment process.
It does not affect the app’s operation after installation.

1. Open Atlassian Account Settings:

   • Go to https://id.atlassian.com/manage-profile/security/api-tokens

   • Or click the button under the API token input field in the app.

2. Click Create API token.
   WARNING Make sure to use Create API token, not Create API token with scopes.

3. 

   Set a name and an expiration date for the token. These values do not affect the app’s functionality, so you can choose any values you prefer.

   

4. After the token is created, copy it immediately.

   WARNING Once you click Done, you will not be able to copy this token again.

   

5. Paste the new token into the API token input field in the app.

6. Click Test connection to verify that the token is valid.

Error Examples

Error text

Your API token lacks the necessary scopes to complete this request. Please ensure your token includes the required scopes and try again.

How does it look?

Error text

The registration failed because your API token lacks the necessary scopes to perform this request. Please ensure your token includes the required scopes for app registration. Verify and update your token's scopes to include all needed permissions.

How does it look?

Jira Permission Issues

This type of error occurs during the app installation phase and indicates that you do not have sufficient permissions to install the app in the selected Jira instance.

Only Jira administrators can install apps. If you are not an admin, the installation will fail.

How to fix it?

There are several ways to resolve this problem:

1. Select a different Jira instance
   Change the Jira instance in the Atlassian domain input field to one where you have administrator access.

2. Request temporary admin access
   Ask a Jira administrator to grant you temporary admin permissions so you can install the app yourself.

3. Ask an admin to install the app for you
   Generate the installation link (see How to Move Forge Apps Built with No-Code Apps Creator to Another Jira Site) and send it to the Jira administrator.
   The admin can use this link to install the app directly.

Error Examples

Error text

There was an authentication error (401) when fetching the flag settings, possibly due to insufficient permissions or invalid credentials. Please verify that your API token has the correct scopes and is properly configured. Ensure that your token includes all necessary scopes for managing feature flags in LaunchDarkly.

How does it look?

Error text

You do not have sufficient permissions to install the app on this site. Please ensure you are an site admin and generate an installation link in the developer console here: https://developer.atlassian.com/console/myapps/{app_id}/distribution .

How does it look?

Atlassian Forge Availability Issues

To deploy your app, we use the Atlassian Forge CLI.
Sometimes Forge experiences temporary outages or service degradation that are outside of our control. In such cases, the deployment may fail due to Forge being unavailable.

How to fix it?

• Check the Atlassian Developer Status page: https://developer.status.atlassian.com/

• If Forge is experiencing an incident or degraded performance, wait for Atlassian to resolve the issue and try deploying again later.

If the status page shows no active incidents, but the error persists, try running the deployment again or contact support.

Error Examples

Error text

There was a network connection issue while trying to contact the Atlassian API, which may be temporary. Ensure your internet connection is stable. No authorization or scope issues are indicated in the message.

How does it look?

Getting Help

1. Click "Contact Support" for technical issues

2. Use the feedback system by clicking "Give Feedback."

Haven't used No-Code Apps Creator yet? You're welcome to try it then!

Have questions or want to see No-Code Apps Creator in action?
Feel free to meet with us — book a demo today!