Reset External Application token

Request

Resets the token for an External Application installation.
This is the only way to obtain app token through Management API v3.
Resetting the token is automatically invalidating previously used token and that operation is unreverisble. Can be used to quickly disable the app if for example token has been compromised.

Security

ApiKeyAuth

Path

subdomainstringrequired

Unique subdomain of requested Hub.

external_application_slugstringrequired

External Application slug

Enum:"minimal_widget""widget""zendesk""statusapi"

Query

api_versionstring

Api version

Value:"V3-R1"

curl -i -X PUT \
  'https://subdomain-of-your-account.app.statushub.io/api/v3/hubs/{subdomain}/external_applications/{external_application_slug}/reset_token?api_version=V3-R1' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json

One of:

Returned for all External Apps except for Status API.

enabledboolean

Status of app:

enabled - Application installations will work for as long as the used token is valid,
disabled - Application installations will not work even if used token is valid.

Example:true

slugstring

External Application slug

Example:"widget"

tokenstring

Token used when installing StatusHub application/widget.
Only one token is valid at a time.
In order to rotate for example compromised token reset token operation can be used.

Example:"0bf65c9c5aca1133e906abf80f02fd9f8066aa94"

Response

{
  "enabled": true,
  "slug": "widget",
  "token": "0bf65c9c5aca1133e906abf80f02fd9f8066aa94"
}