The Organizations REST API provides resources for managing an Atlassian organization. Use this API to:

• Get a list of users in an organization and update their access to products
• Create and update organization policies
• Get lists of domains and events

Permission: Organization admin

Discover additional admin features

Authentication is implemented via an API key. Use the API Key as a Bearer access token to authenticate the script and manage your organization. The Organization ID is used as a unique identifier in the path parameter for the organization. Copy the Organization ID and API key and keep them in a safe place. We won’t show them to you again.

To make requests to the API with the client/tool of your choice, Create an API key and get the organization ID.

A rate limit defines the maximum number of API calls an application or user can perform during a specific time frame. When this threshold is surpassed, or if CPU or total time constraints are exceeded, the application or user might encounter delays. Consequently, API requests initiated by the user or application will not succeed.

It is essential to note that all API requests are subjected to rate limits.

When a client breach the rate limit thresholds, they get HTTP 429 Too Many Requests responses. The client has to wait for the rate limit counter to reset on the server before being able to make successful requests.

Rate limit response headers

The following HTTP response headers are returned indicating the rate and threshold allowed for a client for each endpoint.

• X-RateLimit-Limit: The number of allowed requests in the current period
• X-RateLimit-Remaining: The number of remaining requests in the current period
• X-RateLimit-Reset: Next period reset time (ISO 8601 - Date and time in UTC)

Rate limits of Events API

Rate limits for the following endpoints is specified below:

• GET /v1/orgs/{orgId}/events

• GET /v1/orgs/{orgId}/events/{eventId}

• GET /v1/orgs/{orgId}/event-actions

• Rate limit per user: 60 requests per minute

• Rate limit per API path: 50 requests per minute

These rate limits will be lowered effective end of May 2025 as follows:

• Rate limit per user: 10 requests per minute
• Rate limit per API path: 10 requests per minute

Please migrate to the polling API to guarantee uninterrupted service for use cases involving a high request rate.

Rate limits of Polling API

Rate limits for the following endpoints is specified below:

• GET /v1/orgs/{orgId}/events-stream

• Rate limit per user: 60 requests per minute

• Rate limit per API path: 50 requests per minute

The URIs for resources have the following structure:

1
2
https://api.atlassian.com/admin/<version>/orgs/<resource-name>

The Organizations REST API uses pagination to conserve server resources and limit response size. If there are more results available after the current page, a link to the next page of results is included in the JSON. You can use the cursor parameter to set a specific starting point for the results.

Methods marked as experimental may change without an earlier notice. We are looking for your feedback for these methods.

There are several concepts that are common ideas with a unique meaning in Atlassian Administration. Learn more about terminology related to the cloud admin experience.