REST API

ScriptRunner Connect offers a RESTful API to help you accomplish more with the app.

You can create new API keys and access existing ones from the app by clicking your name at the bottom-left corner of the screen and then clicking API Keys

Base URL  ℹī¸

The base URL is https://docs.api.scriptrunnerconnect.com/

Limited API coverage  🚧

API coverage is currently limited, but it is expected to grow over time. Feel free to contact our support to request more capabilities.

Browsing the API

Authentication

ScriptRunner Connect API utilises basic authentication whereas the user's email is the username and the API key is the password. To generate an API key, click on your name in the left bottom area of the screen, then select API Keys. From there, you can generate a new API key.

Once you have the API key, send it along with the Authorization header as follows: Basic base64Encoded(UserName:ApiKey). When you generate the API Key, you will also receive the base64 encoded Authorization header value, which you can use directly.

Single key per activity  ☝đŸŊ

We recommend generating a new key for each activity. This makes it easier to deactivate the activity by deleting the associated API key.

API keys are not retrievable  💾

Once the key is generated, make a copy and store it securely. Once you have closed the window that exposed the API key, you won't be able to retrieve it again.

Calling the API from ScriptRunner Connect

Although we currently don't offer a connector or a managed API for our own API, you can call API endpoints from a workspace with the generic connector.

Rate limiting

API endpoints are rate-limited; see Limits and Quotas to review the exact limits. If throttled, you'll see a 429 HTTP status code; retry the API call at a later time.

On this page