# External Application

Allows managing StatusHub widgets.
Currently supported applications are:
- Minimal Widget - Small and basic version of StatusHub widget
  intended to be used in places requiring small visual size of the widget,
- Widget - Default Statushub widget,
- Zendesk - StatusHub App for Zendesk -
  [Zendesk Marketplace link](https://www.zendesk.com/marketplace/apps/support/127482/statushub/)


## List External Application installations

 - [GET /hubs/{subdomain}/external_applications](https://api-docs.statushub.com/api-v3-openapi/external-application/listexternalapplications.md): List all of currently supported external applications as well as the
status of the integration for current Hub.
If app is not enabled, it will not work even if its installed with correct
token.
Currently supported applications are:
- Minimal Widget - Small and basic version of StatusHub widget
  intended to be used in places requiring small visual size of the widget,
- Widget - Default Statushub widget,
- Zendesk - StatusHub App for Zendesk -
  Zendesk Marketplace link

## Retrieve an external application installation details

 - [GET /hubs/{subdomain}/external_applications/{external_application_slug}](https://api-docs.statushub.com/api-v3-openapi/external-application/getexternalapplication.md): Show details of a specific External Application installation.
For security reasons, token is not returned. If app token is lost,
in Management API v3 the only way to retrieve a token is to generate
a new one with reset token operation.
In order to install the application, please refer to documentation of
respective CP2 which will contain all necessary snippets and links.

## Update an External Application installation

 - [PUT /hubs/{subdomain}/external_applications/{external_application_slug}](https://api-docs.statushub.com/api-v3-openapi/external-application/updateexternalapplication.md): Updates External Application installation.
Currently the only allowed operation is to enable or disable the app.

## Reset External Application token

 - [PUT /hubs/{subdomain}/external_applications/{external_application_slug}/reset_token](https://api-docs.statushub.com/api-v3-openapi/external-application/resetexternalapplicationtoken.md): 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.