Home > Agendize Scheduling

Staff Groups


Resource representation

{ "id": {string}, "name": {string}, "color": {string}, "workingHours": [ { "day": "monday", "hours": [ { "start": "09:00", "end": "18:00" } ] } ], "members": [ { "id": {string}, "firstName": {string}, "lastName": {string}, "selfLink": {string} } ] }
Parameter name Value Description
id string Identifier of the group.
name string Name of the group.
color string Group color, for dashboard displaying. Hexadecimal web color. Default Color: #EFEFEF.
workingHours list Working hours of the group.
members list Staff list of the group.
members[].firstName string First name of the staff member
members[].lastName string Last name of the staff member
members[].id string Identifier of the staff member
members[].selfLink string API link of the staff member

Delete

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

DELETE https://api.agendize.com/api/2.0/scheduling/companies/{companyId}/staffGroups/{groupId}

Parameters

Parameter name Value Description
Path parameters
companyId string Company identifier.
groupId string Group identifier.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns an empty response body.


Get

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

GET https://api.agendize.com/api/2.0/scheduling/companies/{companyId}/staffGroups/{groupId}

Parameters

Parameter name Value Description
Path parameters
companyId string Company identifier.
groupId string Group identifier.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a Group resource in the response body.


List

Returns entries on the company's staff group list.

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

GET https://api.agendize.com/api/2.0/scheduling/companies/{companyId}/staffGroups

Parameters

Parameter name Value Description
Path parameters
companyId string Company identifier.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response body with the following structure:

{ items: [Group resource] }

Insert

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

POST https://api.agendize.com/api/2.0/scheduling/companies/{companyId}/staffGroups

Parameters

Parameter name Value Description
Path parameters
companyId string Company identifier.

Request body

In the request body, supply a Staff Member resource with the following properties:

Parameter name Value Description
Required Properties
name string Name of the group.
Optional Properties
color string Group color, for dashboard displaying. Hexadecimal web color. Default Color: #EFEFEF.
workingHours list Working hours of the group.
members list Staff list of the group.
members[].id string Identifier of the staff member

Response

If successful, this method returns a Group resource in the response body.


Update

Authentication is required to execute this request. Please refer to Authentication for more.

Request

HTTP Request

PUT https://api.agendize.com/api/2.0/scheduling/companies/{companyId}/staffGroups/{groupId}

Parameters

Parameter name Value Description
Path parameters
companyId string Company identifier.
groupId string Group identifier.

Request body

In the request body, supply a Group resource with the following properties:

Parameter name Value Description
Optional Properties
name string Name of the group.

Response

If successful, this method returns a Group resource in the response body.