GET/directory/users/custom-properties

Gets all the member custom properties of a domain.

Authorization

oauth2

OAuth 2.0 authentication.
For more information, see Authentication and Authorization.

Scope

directory
directory.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/directory/users/custom-properties

Query Parameters

ParameterTypeDescription
domainId integer 

Domain ID


example : 10000001 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
customProperties array (UserCustomProperty) 

Domain member custom property information

 

UserCustomProperty

PropertyTypeDescription
domainId integer 

Domain ID


required
format : int32 
customPropertyId string 

Custom property ID. It is automatically assigned.


readOnly : true 
propertyName string 

Custom property name.
It must be unique within a domain. The name can only contain English alphabet, numbers, and underscores (_). It must start with an alphabetic character or underscore (_).


required
maxLength : 120 
displayName string 

Custom property display name
It must be unique within a domain.


required
maxLength : 20 
i18nDisplayNames array (I18nDisplayName) 

List of multilingual display names


minItems : 0 
propertyType string 

Custom property type

  • STRING: Text
  • LINK: Hyperlink
  • INTEGER: Number
  • DATE: Date

required
Allowed values : STRING, LINK, INTEGER, DATE 
displayOrder integer 

Sort order. Duplicates are allowed. Based on this value, items are sorted in ascending order. If it is not specified (NULL), the custom property is located at the end of the list.


required
minimum : 1
format : int32
nullable : true 
multiValued boolean 

Indicates whether multiple values can be added for the same custom property.


required
default : false 
options array (UserCustomPropertyOption) 

List of options if propertyType is STRING


minItems : 2 
mandatory boolean 

Indicates whether it is mandatory.


required
default : false 
readAccessType string 

Read permission


required
default : ALL
Allowed values : ADMIN_AND_SELF, ALL 
writeAccessType string 

Write permission


required
default : ADMIN
Allowed values : ADMIN, ADMIN_AND_SELF 

I18nDisplayName

PropertyTypeDescription
language string 

Language code


Allowed values : ko_KR, ja_JP, zh_CN, zh_TW, en_US 
name string 

Multilingual name


maxLength : 20 

UserCustomPropertyOption

PropertyTypeDescription
optionName string 

Option name
The name can only contain English alphabet, numbers, and underscores ().


maxLength : 100 
displayName string 

Option display name


maxLength : 20 
i18nDisplayNames array (I18nDisplayName) 

List of multilingual option display names


minItems : 0 

Response Example

example

1{2  "customProperties": [3    {4      "domainId": 10000001,5      "customPropertyId": "customfd-fc09-4a57-ab38-03dc6c425e01",6      "propertyName": "string_single_option",7      "displayName": "Hobby",8      "i18nDisplayNames": [9        {10          "language": "ko_KR",11          "name": "취미"12        },13        {14          "language": "en_US",15          "name": "Hobby"16        }17      ],18      "propertyType": "STRING",19      "displayOrder": 1,20      "multiValued": false,21      "options": [22        {23          "optionName": "option_piano",24          "displayName": "Piano"25        },26        {27          "optionName": "option_cooking",28          "displayName": "Cooking"29        }30      ],31      "mandatory": false,32      "readAccessType": "ALL",33      "writeAccessType": "ADMIN_AND_SELF"34    },35    {36      "domainId": 10000001,37      "customPropertyId": "customfd-fc09-4a57-ab38-03dc6c425e02",38      "propertyName": "date_multi",39      "displayName": "Holidays",40      "propertyType": "DATE",41      "displayOrder": 2,42      "multiValued": true,43      "mandatory": false,44      "readAccessType": "ALL",45      "writeAccessType": "ADMIN_AND_SELF"46    }47  ]48}

HTTP 404

Not Found