Employer Group endpoints
Base URL: /tenants/{tenantName}/groups/employers
Get by id
Get specific employer group by integer ID.
URL: /tenants/{tenantName}/groups/employer/{employerGroupId}
Method: GET
Parameters:
| Name | Type | Required | Description |
| tenantName | String | Yes | The name of the tenant |
| employerGroupId | Integer (int32) | Yes | The id of the employer group to retrieve |
Responses:
| Status code | Status Description |
| 200 | Successful operations |
| 400 | Invalid input |
| 401 | Unauthorised |
| 403 | Permission denied |
| 404 | Not found |
Response body
{
id: integer (int32),
name: string,
parentEmployerGroupId: integer (int32)
}
Create employer group
Creates a new employer group.
URL: /tenants/{tenantName}/groups/employer
Method: POST
Parameters:
| Name | Type | Required | Description |
| tenantName | String | Yes | The name of the tenant |
Request body
{
name: string,
parentEmployerGroupId: integer (int32)
}
Responses:
| Status code | Status Description |
| 200 | Successful operations |
| 400 | Invalid input |
| 401 | Unauthorised |
| 403 | Permission denied |
Response body
{
id: integer (int32),
name: string,
parentEmployerGroupId: integer (int32)
}
Update employer group
Updates an existing employer group.
URL: /tenants/{tenantName}/groups/employer/{employerGroupId}
Method: PUT
Parameters:
| Name | Type | Required | Description |
| tenantName | String | Yes | The name of the tenant |
| employerGroupId | Integer (int32) | Yes | The id of the employer group to update |
Request body
{
name: string,
parentEmployerGroupId: integer (int32)
}
Responses:
| Status code | Status Description |
| 200 | Successful operations |
| 400 | Invalid input |
| 401 | Unauthorised |
| 403 | Permission denied |
| 404 | Not found |
Response body
{
id: integer (int32),
name: string,
parentEmployerGroupId: integer (int32)
}
Delete employer group
Deletes an existing employer group where found.
URL: /tenants/{tenantName}/groups/employer/{employerGroupId}
Method: DELETE
Parameters:
| Name | Type | Required | Description |
| tenantName | String | Yes | The name of the tenant |
| employerGroupId | Integer (int32) | Yes | The id of the employer group to delete |
Responses:
| Status code | Status Description |
| 200 | Successful operations |
| 400 | Invalid input |
| 401 | Unauthorised |
| 403 | Permission denied |
| 404 | Not found |