Time Diaries

Time Diaries are used to modify routing based on the time of day

Become a Reseller

Filter:

All
GET
POST
PUT
DELETE
Chargeable *

* You will be charged every time this command is run.

GET/voip/time-diary

Gets a list of all of the active Out of Hours diaries on an account

Request Details

Response Details

Request Details

This command has no URL/Query String parameters

Response Details

200 Response

{
    "result" : [
        {
            "created_on" : "2022-09-28",
            "elements" : [
                {}
            ],
            "exceptions" : [
                {}
            ],
            "name" : "Pete's Work Schedule",
            "timezone" : "Europe/London",
            "updated_on" : "2022-09-28",
            "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
        }
    ],
    "status_code" : 200,
    "status_message" : "OK"
}

GET/voip/time-diary/{uuid}

Gets the details for a specific Out of Hours diary on an account

Request Details

Response Details

Request Details

URL and Query String Parameters

Name
Type
Required

- uuid
- String
- True
The UUID of the Out of Hours diary to be queried

Response Details

200 Response

{
    "result" : {
        "created_on" : "2022-09-28",
        "elements" : [
            {}
        ],
        "exceptions" : [
            {}
        ],
        "name" : "Pete's Work Schedule",
        "timezone" : "Europe/London",
        "updated_on" : "2022-09-28",
        "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
    },
    "status_code" : 200,
    "status_message" : "OK"
}

404 Response

{
    "result" : {},
    "status_code" : 404,
    "status_message" : "Not Found"
}

POST/voip/time-diary

Creates a new Out of Hours diary

Request Details

Response Details

Request Details

This command has no URL/Query String parameters

POST body

Name
Type
Required

- elements
- Array of TimeDiaryElement
- True
The list of diary elements
- exceptions
- Array of TimeDiaryException
- True
The list of exception times which override the diary elements
- name
- String
- True
The name of this Time Diary
- timezone
- String
- True
The tz database name of the timezone to use for this diary, (see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)

TimeDiaryElement

TimeDiaryException

JSON all-fields example:

{
    "elements" : [
        {}
    ],
    "exceptions" : [
        {}
    ],
    "name" : "Pete's Work Schedule",
    "timezone" : "Europe/London"
}

Response Details

201 Response

{
    "result" : {
        "created_on" : "2022-09-28",
        "elements" : [
            {}
        ],
        "exceptions" : [
            {}
        ],
        "name" : "Pete's Work Schedule",
        "timezone" : "Europe/London",
        "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
    },
    "status_code" : 201,
    "status_message" : "Created"
}

400 Response

{
    "result" : {},
    "status_code" : 400,
    "status_message" : "Bad Request"
}

404 Response

{
    "result" : {},
    "status_code" : 404,
    "status_message" : "Not Found"
}

PUT/voip/time-diary/{uuid}

Updates the specified Out of Hours diary
Back to top

Request Details

Response Details
Request Details

URL and Query String Parameters
- Name
- Type
- Required
- uuid
  
  String
  
  True
  
  The UUID of the Out of Hours diary to be updated
PUT body
- Name
- Type
- Required
- elements
  
  Array of TimeDiaryElement
  
  True
  
  The list of diary elements
- exceptions
  
  Array of TimeDiaryException
  
  True
  
  The list of exception times which override the diary elements
- name
  
  String
  
  True
  
  The name of this Time Diary
- timezone
  
  String
  
  True
  
  The tz database name of the timezone to use for this diary, (see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
TimeDiaryElement
TimeDiaryException
JSON all-fields example:
{ "elements" : [ {} ], "exceptions" : [ {} ], "name" : "Pete's Work Schedule", "timezone" : "Europe/London" }
Response Details

201 Response
```
{
    "result" : {
        "created_on" : "2022-09-28",
        "elements" : [
            {}
        ],
        "exceptions" : [
            {}
        ],
        "name" : "Pete's Work Schedule",
        "timezone" : "Europe/London",
        "updated_on" : "2022-09-28",
        "uuid" : "31347d42-00bd-44a5-9b5c-20dc4197a2f6"
    },
    "status_code" : 201,
    "status_message" : "Created"
}
```
400 Response
```
{
    "result" : {},
    "status_code" : 400,
    "status_message" : "Bad Request"
}
```
404 Response
```
{
    "result" : {},
    "status_code" : 404,
    "status_message" : "Not Found"
}
```
DELETE/voip/time-diary/{uuid}

Deletes the specified Out of Hours diary
Back to top

Request Details

Response Details
Request Details

URL and Query String Parameters
- Name
- Type
- Required
- uuid
  
  String
  
  True
  
  The UUID of the Out of Hours diary to be deleted
Response Details

204 Response
```
{
    "result" : {},
    "status_code" : 204,
    "status_message" : "No Content"
}
```
404 Response
```
{
    "result" : {},
    "status_code" : 404,
    "status_message" : "Not Found"
}
```