# Service

Service represents fundamental Hub entity. Incident and Maintenance events
are always attached to at least one Service. Service status should
represent the health of the actual real-life entity it represents.


## List Services

 - [GET /hubs/{subdomain}/services](https://api-docs.statushub.com/api-v3-openapi/service/listservices.md): Filters and returns services for current Hub. Can return services from all groups. Request valid only in scope of Primary or Standalone Hub and can't be used in scope of a Connected Hub.

## Create a Service

 - [POST /hubs/{subdomain}/services](https://api-docs.statushub.com/api-v3-openapi/service/createservice.md): Creates a new service in a group. Request valid only in scope of Primary or Standalone Hub and can't be used in scope of a Connected Hub.

## Retrieve a Service

 - [GET /hubs/{subdomain}/services/{service_id}](https://api-docs.statushub.com/api-v3-openapi/service/getservice.md): Returns data about single service. Request valid only in scope of Primary or Standalone Hub and can't be used in scope of a Connected Hub.

## Update a Service

 - [PUT /hubs/{subdomain}/services/{service_id}](https://api-docs.statushub.com/api-v3-openapi/service/updateservice.md): Updates data of a service. Request valid only in scope of Primary or Standalone Hub and can't be used in scope of a Connected Hub.

## Delete a Service

 - [DELETE /hubs/{subdomain}/services/{service_id}](https://api-docs.statushub.com/api-v3-openapi/service/deleteservice.md): Deletes a service. Request valid only in scope of Primary or Standalone Hub and can't be used in scope of a Connected Hub. Deletion is a soft deletion, service can be restored later.

## Archive a Service

 - [PUT /hubs/{subdomain}/services/{service_id}/archive](https://api-docs.statushub.com/api-v3-openapi/service/archiveservice.md): Archives a service. Request valid only in scope of Primary or Standalone Hub and can't be used in scope of a Connected Hub. Archived services are not returned by index endpoint unless archived parameter is set to true.

## Update a Service position

 - [PUT /hubs/{subdomain}/services/{service_id}/reorder](https://api-docs.statushub.com/api-v3-openapi/service/reorderservice.md): Updates position of a service in a group. Request valid only in scope of Primary or Standalone Hub and can't be used in scope of a Connected Hub.