Home > Agendize Scheduling

Appointment Statuses


Resource representation

{ "id": {string}, "name": {string}, "color": {string}, "description": {string}, "native": {boolean} }
Parameter name Value Description Notes
id string Identifier of the status. read-only
name string Name of the status. writable. Max length 127.
description string Description of the status. writable. Max length 65536.
color string Color of the status. HTML Color format: #xxxxxx writable
native string If is a platform predefined status. Read-only. read-only

Delete

Deletes an entry on the status list. Only no native status can be deleted.

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

Request

HTTP Request

DELETE https://api.agendize.com/api/2.3/scheduling/statuses/{statusId}

Parameters

Parameter name Value Description
Path parameters
statusId string Status identifier.

Request body

Do not supply a request body with this method.

Response

If successful, this method returns an empty response body.


Get

Returns an entry of the status list. Only with no native statuses

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

Request

HTTP Request

GET https://api.agendize.com/api/2.3/scheduling/statuses/{statusId}

Parameters

Parameter name Value Description
Path parameters
statusId string Status identifier.

Request body

Do not supply a request body with this method.

Response

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


List

Returns entries on the status list.

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

Request

HTTP Request

GET https://api.agendize.com/api/2.3/scheduling/statuses

Parameters

Parameter name Value Description
Optional query parameters
appointmentId datetime Gets available change statuses for an appointment.

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: [Status resource] }

Insert

Adds an entry to the status list.

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

Request

HTTP Request

POST https://api.agendize.com/api/2.3/scheduling/statuses

Request body

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

Parameter name Value Description
Required Property
name string Name of the status. writable. Max length 127.
Optional Properties
description string Description of the status. writable. Max length 65536.
color string Color of the status. HTML Color format: #xxxxxx writable

Response

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


Update

Updates an entry on the status list.

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

Request

HTTP Request

PUT https://api.agendize.com/api/2.3/scheduling/statuses/{statusId}

Parameters

Parameter name Value Description
Path parameters
statusId string Status identifier.

Request body

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

Parameter name Value Description
Optional Properties
name string Name of the status. writable. Max length 127.
description string Description of the status. writable. Max length 65536.
color string Color of the status. HTML Color format: #xxxxxx writable
native string If is a platform predefined status. Read-only. read-only

Response

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