The Admin Key feature is only offered with Confluence Cloud Premium and Enterprise to organization or site admins.
NOTE: Users can only make calls to our public REST APIs using a valid Admin Key by adding the following HTTP header on their requests: Atl-Confluence-With-Admin-Key: true
. Visit the Confluence Cloud Changelog for more details.
Returns information about the admin key if one is currently enabled for the calling user within the site.
Permissions required: User must be an organization or site admin.
Forge and OAuth2 apps cannot access this REST resource.
Connect apps cannot access this REST resource.
This request has no parameters.
Returned if an admin key is currently enabled for the calling user.
1
2
3
curl --request GET \
--url 'https://{your-domain}/wiki/api/v2/admin-key' \
--header 'Accept: application/json'
1
2
3
4
{
"accountId": "<string>",
"expirationTime": "<string>"
}
Enables admin key access for the calling user within the site. If an admin key already exists for the user, a new one will be issued with an updated expiration time.
Note: The durationInMinutes
field within the request body is optional. If the request body is empty or if the durationInMinutes
is set to 0 minutes, a new admin key will be issued to the calling user with a default duration of 10 minutes.
Permissions required: User must be an organization or site admin.
Forge and OAuth2 apps cannot access this REST resource.
Connect apps cannot access this REST resource.
integer
Returned if a new admin key is successfully issued for the calling user.
1
2
3
4
5
6
7
curl --request POST \
--url 'https://{your-domain}/wiki/api/v2/admin-key' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"durationInMinutes": 60
}'
1
2
3
4
{
"accountId": "<string>",
"expirationTime": "<string>"
}
Disables admin key access for the calling user within the site.
Permissions required: User must be an organization or site admin.
Forge and OAuth2 apps cannot access this REST resource.
Connect apps cannot access this REST resource.
This request has no parameters.
Returned if admin key access was successfully disabled for the calling user or if the user did not have an admin key in the first place.
1
2
curl --request DELETE \
--url 'https://{your-domain}/wiki/api/v2/admin-key'
Rate this page: