Datasource (option list)

Note

Datasources are currently known as Option lists, but the renaming hasn't been fully applied yet.

Parameters

Parameter	Type	Description
`name`	String	Can only contain letters, numbers, dots or underscores. Because it is used as an identifier, this also needs to be unique.
`labels`	`Labels`	Optional. The translation(s) of the canonical name.
`type`	String	Flat disables nesting of option list items, Hierarchical enables nesting option list items. If it set to Flat and the values array contains nested items, it will throw an error.
`values`	Array. <[DatasourceValue`]('datasource-value.md')>	The Option list items that belong to the option list.
`is_system_owned`	Boolean	false allows the option list to be editable, true locks the option list preventing any further modifications. When creating an option list using the API, you should always use false, which is the default value.

Examples

RequestResponse

{
  "name": "Groceries",
  "labels": {
    "en-US": "Groceries",
    "nl-BE": "Boodschappen"
  },
  "type": "Hierarchical",
  "values": [
    {
      "identifier" : "Bread",
      "labels": {
        "en-US": "Bread",
        "nl-BE": "Brood"
      },
      "values" : []
    },
    {
      "identifier" : "Spreads",
      "values" : [
        {
          "identifier" : "Peanut butter",
          "values" : []
        },
        {
          "identifier" : "Jam",
          "values" : []
        }
      ]
    },
  ],
  "is_system_owned": false
}

Do you have some feedback for us?

If you have suggestions for improving this article,