| Required role: | User |
| PATCH | /app/settings-objects/{id} |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Id | path | string | No | The ID of the settings object |
| Data | query | Struct | No | The data values to set |
| 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 |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Id | form | string | No | |
| Name | form | string | No | |
| Description | form | string | No | |
| ReadOnly | form | bool | No | |
| Type | form | SettingsObjectTypes | No | |
| EndpointType | form | EndpointTypes? | No | |
| Fields | form | List<SettingsField> | No |
| Endpoint | |
| Customer |
| PhoneNumber | |
| User | |
| FaxNumber | |
| EmailAddress | |
| Unused_1 | |
| Unused_2 | |
| Unused_3 | |
| Unused_4 | |
| Unused_5 | |
| Team | |
| Assistant |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Name | form | string | No | |
| DisplayName | form | string | No | |
| Type | form | ValueTypes | No | |
| Value | form | Value | No | |
| ReadOnly | form | bool | No | |
| PossibleValues | form | List<SettingsPossibleValue> | No | |
| DataField | form | DataField | 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 |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| DisplayName | form | string | No | |
| 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 |
| None | |
| LargeText | |
| InlineForm | |
| Password | |
| InlineStruct |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| TypeName | form | string | No | |
| Fields | form | List<DataField> | No |
| NotUnique | |
| Unique | |
| UniqueToCustomer |
| Hidden | |
| ReadOnly | |
| ReadWrite |
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
PATCH /app/settings-objects/{id} HTTP/1.1
Host: team.evovoice.io
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<PatchSettingsObject xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.App">
<Data xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" />
<Id>String</Id>
</PatchSettingsObject>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length
<SettingsObject xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api.App">
<Description>String</Description>
<EndpointType>PhoneNumber</EndpointType>
<Fields>
<SettingsField>
<DataField xmlns:d4p1="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data" i:nil="true" />
<DisplayName>String</DisplayName>
<Name>String</Name>
<PossibleValues>
<SettingsPossibleValue>
<DisplayName>String</DisplayName>
<Value xmlns:d6p1="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">
<d6p1:BoolValue>false</d6p1:BoolValue>
<d6p1:ListValue xmlns:d7p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d7p1:ArrayOfKeyValueOfstringValue8Ahp2kgT i:nil="true" />
</d6p1:ListValue>
<d6p1:NumberValue>0</d6p1:NumberValue>
<d6p1:StringValue>String</d6p1:StringValue>
<d6p1:StructValue xmlns:d7p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" />
</Value>
</SettingsPossibleValue>
</PossibleValues>
<ReadOnly>false</ReadOnly>
<Type>NotSpecified</Type>
<Value xmlns:d4p1="http://schemas.datacontract.org/2004/07/Voice.Api.Flows.Data">
<d4p1:BoolValue>false</d4p1:BoolValue>
<d4p1:ListValue xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<d5p1:ArrayOfKeyValueOfstringValue8Ahp2kgT i:nil="true" />
</d4p1:ListValue>
<d4p1:NumberValue>0</d4p1:NumberValue>
<d4p1:StringValue>String</d4p1:StringValue>
<d4p1:StructValue xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" />
</Value>
</SettingsField>
</Fields>
<Id>String</Id>
<Name>String</Name>
<ReadOnly>false</ReadOnly>
<Type>Endpoint</Type>
</SettingsObject>