Update DropDowns

The EasyLife 365 Collaboration API facilitates the direct updating of dropdown field options. This feature enables the dynamic modification of dropdown field options based on external data sources. For instance, when new departments are added to the Human Resources system, the list of departments on EasyLife 365 Collaboration can be automatically updated.

Permissions

Permission Type	Permissions (Scope)
Delegated (work or school account)	https://api.insiders.easylife365.cloud/admin/Config.ReadWrite.All
Application	Not supported.

HTTP Request

POST https://api.insiders.easylife365.cloud/admin/v1/fields/select/{field-name}/
Content-Type: application/json

HTTP Request Headers

Header	Value
Authorization	Bearer token. (Required)
Content-Type	application/json

Request Body

Property	Type	Description
defaultValue	String	Default value of the dropdown. (Optional)
options	Object	List of key/value pairs representing dropdown options. The key is the option key, and the value is the displayed option value. (Required)
translations	Object	List of translated values in different languages. Supported languages are "de", "it", "fr", "es", "pl", "tr", "nl". (Optional)

Response

This endpoint does not provide a response.

Example 1: Update Dropdown Field

This example updates the dropdown field "el-check-428" with the default value "key1" and includes the translation in German.

POST https://api.insiders.easylife365.cloud/admin/v1/fields/select/{field-name}/
Content-Type: application/json

{
  "defaultValue": "key1",
  "options": {
    "key1": "value1",
    "key2": "value2"
  },
  "translations": {
    "de": [
      "value1de",
      "value2de"
    ]
  }
}

Example 2: Update Dropdown Field using PowerShell

The following example demonstrates updating a field using PowerShell. Before executing the script, ensure you've registered an application and obtained the TenantId and ClientId. Also, retrieve the correct scope from this document.

Import-Module MSAL.PS

$msalParam = @{
    tenantId = "[TENANT_ID]"
    clientId = "[CLIENT_ID]"
    scopes = "[SCOPE]"
}
$uri = "[URI]"

# Get JWT authentication token.
if($token){
    $token = Get-MsalToken @msalParam -Silent
} else {
    $token = Get-MsalToken @msalParam -DeviceCode
}

# Create object with values to pass to the API.
$body = @{
  defaultValue = "key1"
  options = @{
    key1 = "value1"
    key2 = "value2"
  }
  translations = @{
    de = @(
      "value1de",
      "value2de"
    )
  }
}

# Invoke the API and capture responses.
$jsonBody = $body | ConvertTo-Json -Depth 5 -Compress
$encodedBody = [System.Text.Encoding]::UTF8.GetBytes($jsonBody)

$headers = @{ 
    "Authorization"= "Bearer $($token.AccessToken)"
    "Content-Type" = "application/json"
}

Write-Information "Updating field with: $jsonBody" -InformationAction Continue
Invoke-RestMethod -Method PATCH -Uri $uri -Headers $headers -Body $encodedBody