Atlassian app REST APIs

Forge apps can use the following Atlassian app REST APIs:

• Bitbucket Cloud REST API
• Confluence Cloud REST API
• Jira Cloud REST API
• Jira Service Management REST API
• Jira Software Cloud REST API

To call an Atlassian app REST API using the Authenticated Atlassian app Fetch APIs the operation must support OAuth 2.0 authentication. In the Atlassian app API documentation, this is shown by the OAuth scopes required field, which documents the required OAuth 2.0 scope for that operation.

Calling an unsupported operation with asUser() returns a 401 error.

Atlassian app fetch API

The fetch API also enables you to make requests to Atlassian app APIs through the following endpoints:

• requestBitbucket
• requestConfluence
• requestJira
• requestGraph (for Compass and other APIs exposed through the Atlassian GraphQL Gateway)

OAuth 2.0 scopes

Scopes define the operations that an app is permitted to use in an Atlassian app REST API.

See Add scopes to call an Atlassian REST API for instructions on how to add scopes to Forge apps, or Scopes for the list of supported OAuth 2.0 scopes.

GraphQL APIs

Atlassian apps such as Compass use the Atlassian platform GraphQL API rather than a REST API. To call GraphQL APIs from a Forge app, use Forge's requestGraph method.

As an alternative to requestGraph, Compass also provides a GraphQL API Toolkit for commonly used calls to the GraphQL API.