Value Lists API

In order to create a value list you first have to create all the values that you want to add to the list as described here: Add Values to Key, and you have to have the id of the key that you want to add the values to.

1 Creating a Value List
- 1.1 SDK
- 1.2 REST API
2 Get a Value List
- 2.1 SDK
- 2.2 REST API

Creating a Value List

SDK

Use tab completion with SDK to auto-complete function names or show field options!

n/a

REST API

POST /api/v0/value_lists

Headers

Content-Type application/json
Authorization "yourAuthToken"

Body (example)

{

"name": "My Value List",

"key_id": "456",

"value_ids": [ 51643, 51644, 51645 ]

}

Required parameters: name, key_id (the id of the key you want to add the values to)

Response

Status code 200

{
    "id": 321,
    "name": "my_value_list",
    "description": null,
    "account_id": 391,
    "key_id": 456,
    "free_values": [],
    "value_ids": [51643, 51644, 51645 ],
    "created_at": "2019-07-12T16:49:50.754Z"
}

Get a Value List

SDK

n/a

REST API

GET /api/v0/value_lists/<id>

Headers

Content-Type application/json
Authorization "yourAuthToken"

Response

Status code 200

{
    "id": 321,
    "name": "my_value_list",
    "description": "",
    "account_id": 391,
    "key_id": 456,
    "free_values": [],
    "value_ids": [
        51643, 51644, 51645 
    ],
    "created_at": "2019-04-30T15:26:00.605Z"
}

If you want to add new values to the list you have to replace all the values in the list.