| Requires any of the roles: | SystemAdministrator, Manager, Customer |
| GET | /system/settings |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| AccountId | query | string | No | The account ID whose system settings you want |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| OverrideSystemTime | form | bool | No | Use to override the system time for testing |
| OverrideSystemTimeZoneId | form | string | No | The system override time zone |
| OverrideSystemDateTime | form | string | No | The system override date/time |
| SystemFields | form | List<SystemSettingsField> | No | The list of system settings fields |
| CustomerFields | form | List<CustomerDataField> | No | The list of customer metadata fields |
| EndpointFields | form | List<EndpointDataField> | No | The list of endpoint metadata fields |
| EmailAccounts | form | List<EmailAccount> | No | The list of email accounts |
| Tags | form | List<Tag> | No | The list of tags in the system |
| Documentation | form | string | No | Documentation for the account |
| RecordingRetentionDays | form | int | No | The number of days recordings are retained |
| EnableSipRefer | form | bool | No | Enable the SIP refer beta |
| AutoAgentLogoffSeconds | form | int | No | The number of seconds after which we automatically logoff a not ready agent |
| DefaultSipRegion | form | TwilioSipRegions? | No | The default SIP region for new devices |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Id | form | string | No | The ID of the object |
| DateCreated | form | string | No | The date the object was created |
| DateLastModified | form | string | No | The date the object was last modified |
| CreatedBy | form | string | No | The user that created this object |
| LastModifiedBy | form | string | No | The user that last modified this object |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Value | form | Value | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Id | form | string | No | |
| Name | form | string | No | |
| Type | form | ValueTypes | No | |
| UIHint | form | UIHints | No | |
| UITab | form | string | No | |
| IsAsync | form | bool | No | |
| DisableBinding | form | bool | No | |
| StructType | form | DataType | No | |
| ListType | form | DataType | No | |
| Description | form | string | No | |
| PossibleValues | form | List<string> | No | |
| IsOutput | form | bool | No | |
| CustomFieldValuesUrl | form | string | No | |
| DefaultValue | form | Value | No | |
| TransitionNameFormat | form | string | No | |
| Uniqueness | form | DataFieldUniqueness | No | |
| VoiceOnly | form | bool | No | |
| ConditionalVisibilityField | form | string | No | |
| ConditionalVisibilityValue | form | string | No | |
| NoEvalTemplate | form | bool | No | |
| UserMode | form | UserDataFieldModes | No | |
| AnyValueType | form | bool | No |
| NotSpecified | |
| String | |
| Boolean | |
| Number | |
| List | |
| Struct | |
| Transition | |
| Custom | |
| Date | |
| AudioFile | |
| TimeZoneId | |
| PhoneNumber | |
| User | |
| Endpoint | |
| Time | |
| File | |
| FaxNumber | |
| EmailAccount | |
| Customer | |
| Flow | |
| Team | |
| FlowReference | |
| Integration | |
| Assistant |
| None | |
| LargeText | |
| InlineForm | |
| Password | |
| InlineStruct |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| TypeName | form | string | No | |
| Fields | form | List<DataField> | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| BoolValue | form | bool? | No | |
| StringValue | form | string | No | |
| NumberValue | form | double? | No | |
| ListValue | form | List<Struct> | No | |
| StructValue | form | Struct | No |
| NotUnique | |
| Unique | |
| UniqueToCustomer |
| Hidden | |
| ReadOnly | |
| ReadWrite |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ShowInSearch | form | bool | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ShowInSearch | form | bool | No | |
| ShowInLists | form | bool | No | |
| EndpointType | form | EndpointTypes? | No | |
| IsCallerId | form | bool | No | |
| IsKnob | form | bool | No |
| PhoneNumber | |
| User | |
| FaxNumber | |
| EmailAddress | |
| Unused_1 | |
| Unused_2 | |
| Unused_3 | |
| Unused_4 | |
| Unused_5 | |
| Team | |
| Assistant |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Id | form | string | No | |
| Server | form | string | No | |
| UserName | form | string | No | |
| Port | form | int | No | |
| EmailAddress | form | string | No | |
| DisplayName | form | string | No | |
| Password | form | string | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Id | form | string | No | |
| Name | form | string | No | |
| Color | form | TagColors | No |
| Magenta | |
| Red | |
| Volcano | |
| Orange | |
| Gold | |
| Lime | |
| Green | |
| Cyan | |
| Blue | |
| GeekBlue | |
| Purple |
| NorthAmericaVirginia | |
| NorthAmericaOregon | |
| EuropeIreland | |
| EuropeFrankfurt | |
| AsiaPacificSingapore | |
| AsiaPacificTokyo | |
| AsiaPacificSydney | |
| SouthAmericaSanPaolo |
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /system/settings HTTP/1.1 Host: evovoice.io Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length
{
overrideSystemTime: False,
overrideSystemTimeZoneId: String,
overrideSystemDateTime: String,
systemFields:
[
{
value:
{
boolValue: False,
stringValue: String,
numberValue: 0,
listValue:
[
null
]
},
id: String,
name: String,
type: NotSpecified,
uiHint: None,
uiTab: String,
isAsync: False,
disableBinding: False,
description: String,
possibleValues:
[
String
],
isOutput: False,
customFieldValuesUrl: String,
defaultValue:
{
boolValue: False,
stringValue: String,
numberValue: 0,
listValue:
[
null
]
},
transitionNameFormat: String,
uniqueness: NotUnique,
voiceOnly: False,
conditionalVisibilityField: String,
conditionalVisibilityValue: String,
noEvalTemplate: False,
userMode: Hidden,
anyValueType: False
}
],
customerFields:
[
{
showInSearch: False,
id: String,
name: String,
type: NotSpecified,
uiHint: None,
uiTab: String,
isAsync: False,
disableBinding: False,
description: String,
possibleValues:
[
String
],
isOutput: False,
customFieldValuesUrl: String,
defaultValue:
{
boolValue: False,
stringValue: String,
numberValue: 0,
listValue:
[
null
]
},
transitionNameFormat: String,
uniqueness: NotUnique,
voiceOnly: False,
conditionalVisibilityField: String,
conditionalVisibilityValue: String,
noEvalTemplate: False,
userMode: Hidden,
anyValueType: False
}
],
endpointFields:
[
{
showInSearch: False,
showInLists: False,
endpointType: PhoneNumber,
isCallerId: False,
isKnob: False,
id: String,
name: String,
type: NotSpecified,
uiHint: None,
uiTab: String,
isAsync: False,
disableBinding: False,
description: String,
possibleValues:
[
String
],
isOutput: False,
customFieldValuesUrl: String,
defaultValue:
{
boolValue: False,
stringValue: String,
numberValue: 0,
listValue:
[
null
]
},
transitionNameFormat: String,
uniqueness: NotUnique,
voiceOnly: False,
conditionalVisibilityField: String,
conditionalVisibilityValue: String,
noEvalTemplate: False,
userMode: Hidden,
anyValueType: False
}
],
emailAccounts:
[
{
id: String,
server: String,
userName: String,
port: 0,
emailAddress: String,
displayName: String,
password: String
}
],
tags:
[
{
id: String,
name: String,
color: Magenta
}
],
documentation: String,
recordingRetentionDays: 0,
enableSipRefer: False,
autoAgentLogoffSeconds: 0,
defaultSipRegion: NorthAmericaVirginia,
id: String,
dateCreated: String,
dateLastModified: String,
createdBy: String,
lastModifiedBy: String
}