Cloud

API Access / Reference / REST API

API Key

Postman Collection

OpenAPI

API Key APIs

Operations

GET/orgs/{orgId}/api-keys/count GET/orgs/{orgId}/api-keys PATCH/orgs/{orgId}/api-keys/revoke/{apiKeyId}

GET

Get API key count in an org

Gets count of user API keys in an organization.

Scopes

OAuth 2.0 scopes required: read:tokens:admin

Forge and OAuth2 apps cannot access this REST resource.

Request

Path parameters

orgId

string

Required

Query parameters

string

keyType

string

expiresAtSearchType

string

expiresAtUom

string

expiresAtValue

integer

expiresAtFrom

string

expiresAtTo

string

expiresAtRangeFrom

string

expiresAtRangeTo

string

lastActiveAtSearchType

string

Header parameters

Authorization

string

Required

Responses

Returned if the request is successful.

Headers

X-RateLimit-Limit

integer

X-RateLimit-Remaining

integer

X-RateLimit-Reset

string

application/json

integer

GET/orgs/{orgId}/api-keys/count

curl

Node.js

Java

Python

PHP

1
2
3

curl --request GET \
  --url 'https://api.atlassian.com/admin/api-access/v1/orgs/{orgId}/api-keys/count' \
  --header 'Accept: application/json'

GET

Get all API keys in an org

Gets all user API keys in an organization.

Scopes

OAuth 2.0 scopes required: read:tokens:admin

Forge and OAuth2 apps cannot access this REST resource.

Request

Path parameters

orgId

string

Required

Query parameters

string

keyType

string

expiresAtSearchType

string

expiresAtUom

string

expiresAtValue

integer

expiresAtFrom

string

expiresAtTo

string

expiresAtRangeFrom

string

expiresAtRangeTo

string

lastActiveAtSearchType

string

Header parameters

Authorization

string

Required

Responses

Returned if the request is successful.

Headers

X-RateLimit-Limit

integer

X-RateLimit-Remaining

integer

X-RateLimit-Reset

string

application/json

ApiKeySearchResponse

GET/orgs/{orgId}/api-keys

curl

Node.js

Java

Python

PHP

1
2
3

curl --request GET \
  --url 'https://api.atlassian.com/admin/api-access/v1/orgs/{orgId}/api-keys' \
  --header 'Accept: application/json'

200Response

{
  "data": [
    {
      "id": "<string>",
      "label": "<string>",
      "createdAt": "<string>",
      "expiresAt": "<string>",
      "lastActiveAt": "<string>",
      "systemAccountId": "<string>",
      "resource": "<string>",
      "orgId": "<string>",
      "createdBy": {
        "id": "<string>",
        "name": "<string>",
        "email": "<string>"
      },
      "scopes": [
        "<string>"
      ]
    }
  ],
  "links": {
    "self": "<string>",
    "next": "<string>",
    "prev": "<string>"
  }
}

PATCH

Revoke an API key for an org

Revokes an existing API key

Scopes

OAuth 2.0 scopes required: delete:tokens:admin

Forge and OAuth2 apps cannot access this REST resource.

Request

Path parameters

orgId

string

Required

apiKeyId

string

Required

Responses

Returned if the request is successful.

Headers

X-RateLimit-Limit

integer

X-RateLimit-Remaining

integer

X-RateLimit-Reset

string

PATCH/orgs/{orgId}/api-keys/revoke/{apiKeyId}

curl

Node.js

Java

Python

PHP

1
2

curl --request PATCH \
  --url 'https://api.atlassian.com/admin/api-access/v1/orgs/{orgId}/api-keys/revoke/{apiKeyId}'