# Hub

Hub is a central record that represents the status page and holds
all related records.


## List of Hubs

 - [GET /hubs](https://api-docs.statushub.com/api-v3-openapi/hub/paths/~1hubs/get.md): Filters and returns Hub records with basic info.

## Show Hub

 - [GET /hubs/{subdomain}](https://api-docs.statushub.com/api-v3-openapi/hub/paths/~1hubs~1%7Bsubdomain%7D/get.md): Returns data about single Hub.

## Update hub

 - [PUT /hubs/{subdomain}](https://api-docs.statushub.com/api-v3-openapi/hub/paths/~1hubs~1%7Bsubdomain%7D/put.md): Modifies basic settings of an existing Hub. Only modified attributes may be passed in payload. All other attributes will remain unchanged.

## Hub services conditions overview

 - [GET /hubs/{subdomain}/status/counters](https://api-docs.statushub.com/api-v3-openapi/hub/paths/~1hubs~1%7Bsubdomain%7D~1status~1counters/get.md): Returns Hub services conditions overview

## List of Connected Hubs

 - [GET /hubs/{subdomain}/connected_hubs](https://api-docs.statushub.com/api-v3-openapi/hub/paths/~1hubs~1%7Bsubdomain%7D~1connected_hubs/get.md): Filters and returns Connected Hub records for current Primary Hub with basic info. Request valid only in scope of Primary Hub and can't be used in scope of a Connected Hub.

## Create a new Connected Hub

 - [POST /hubs/{subdomain}/connected_hubs](https://api-docs.statushub.com/api-v3-openapi/hub/paths/~1hubs~1%7Bsubdomain%7D~1connected_hubs/post.md): Creates a new Connected Hub for current Primary Hub. Request valid only in scope of Primary Hub and can't be used in scope of a Connected Hub.

## Show Connected Hub

 - [GET /hubs/{subdomain}/connected_hubs/{connected_subdomain}](https://api-docs.statushub.com/api-v3-openapi/hub/paths/~1hubs~1%7Bsubdomain%7D~1connected_hubs~1%7Bconnected_subdomain%7D/get.md): Returns data about single Connected Hub.

## Update Connected Hub

 - [PUT /hubs/{subdomain}/connected_hubs/{connected_subdomain}](https://api-docs.statushub.com/api-v3-openapi/hub/paths/~1hubs~1%7Bsubdomain%7D~1connected_hubs~1%7Bconnected_subdomain%7D/put.md): Modifies basic settings of an existing Connected Hub. Only modified attributes may be passed in payload. All other attributes will remain unchanged.

## Delete a Connected Hub

 - [DELETE /hubs/{subdomain}/connected_hubs/{connected_subdomain}](https://api-docs.statushub.com/api-v3-openapi/hub/paths/~1hubs~1%7Bsubdomain%7D~1connected_hubs~1%7Bconnected_subdomain%7D/delete.md): Deletes Connected Hub record.

## Copy Connected Hub

 - [POST /hubs/{subdomain}/connected_hubs/{connected_subdomain}/copy](https://api-docs.statushub.com/api-v3-openapi/hub/paths/~1hubs~1%7Bsubdomain%7D~1connected_hubs~1%7Bconnected_subdomain%7D~1copy/post.md): Creates a new Connected Hub with same settings as existing Connected Hub.
Copying will preserve all configuration options which includes:
- Hub properties (excluding custom domain)
- Privacy settings
- List of associated services and groups
- Appearance settings
- Notification settings
- Features enabled by StatusHub support

Copy will not copy events nor subscribers data.

## Show Hub appearance settings

 - [GET /hubs/{subdomain}/appearance](https://api-docs.statushub.com/api-v3-openapi/hub/paths/~1hubs~1%7Bsubdomain%7D~1appearance/get.md): Returns data about Hub appearance settings.

## Update Hub appearance settings

 - [PUT /hubs/{subdomain}/appearance](https://api-docs.statushub.com/api-v3-openapi/hub/paths/~1hubs~1%7Bsubdomain%7D~1appearance/put.md): Modifies an existing Hub appearance settings. Only modified attributes may be passed in payload. All other attributes will remain unchanged.