Component Groups
Manage groups of components to organize your status page.
X-API-KEY Required for all endpoints in this section.
List All Component Groups
Retrieve a list of all component groups and their current status.
HTTP Method & URL: GET /api/admin/ComponentGroup
Request
- Headers
- cURL
| Name | Value | Required | Description |
|---|---|---|---|
X-API-KEY | string | Yes | Your unique API key. |
curl -X GET "https://stg.itechops.com/api/admin/ComponentGroup" \
-H "X-API-KEY: your_api_key_here"
Responses
- 200 OK
- 401 Unauthorized
- 500 Server Error
Description: Success. Returns a list of component groups.
Response Body: ApiResponse<List<ComponentGroupModel>>
{
"Success": true,
"Result": [
{
"ComponentGroupId": "3fa85f64-5717-4562-b3fc-2c963f66afa0",
"ComponentGroupName": "Core Services",
"ComponentGroupDescription": "Critical infrastructure components.",
"Sequence": 1
}
],
"Message": ""
}
Description: Authentication failed.
Description: Internal server error.
Get Component Group by ID
Retrieve details for a specific component group.
HTTP Method & URL: GET /api/admin/ComponentGroup/id/{id}
Request
- Path Parameters
id: (Guid) The unique ID of the component group.
Responses
- 200 OK
- 401 Unauthorized
- 404 Not Found
- 500 Server Error
Description: Success.
Response Body: ApiResponse<ComponentGroupModel>
Description: Authentication failed.
Description: Group not found.
Description: Internal server error.
Create Component Group
Add a new component group.
HTTP Method & URL: POST /api/admin/ComponentGroup
Request
- Payload
- cURL
Body: ComponentGroupModel
{
"ComponentGroupName": "Internal Tools",
"ComponentGroupDescription": "Non-customer facing tools",
"Sequence": 2
}
curl -X POST "https://stg.itechops.com/api/admin/ComponentGroup" \
-H "X-API-KEY: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"ComponentGroupName": "Internal Tools",
"ComponentGroupDescription": "Non-customer facing tools",
"Sequence": 2
}'
Responses
- 200 OK
- 400 Bad Request
- 401 Unauthorized
- 500 Server Error
Description: Success. Returns the ID of the created group.
Description: Validation error.
Description: Authentication failed.
Description: Internal server error.
Update Component Group
Modify an existing component group.
HTTP Method & URL: PUT /api/admin/ComponentGroup
Request
- Payload
Body: ComponentGroupModel
Responses
- 200 OK
- 401 Unauthorized
- 500 Server Error
Description: Success.
Description: Authentication failed.
Description: Internal server error.
Delete Component Group
Remove a component group.
HTTP Method & URL: DELETE /api/admin/ComponentGroup/{id}
Request
- Path Parameters
id: (Guid) The unique ID of the component group.
Responses
- 200 OK
- 401 Unauthorized
- 500 Server Error
Description: Success.
Description: Authentication failed.
Description: Internal server error.