Create a value list item
POST / v1 / radar / value_list_items
Creates a new ValueListItem object, which is added to the specified parent value list.
Parameters
- value string Required The value of the item (whose type must match the type of the parent value list). The maximum length is 800 characters.
- value _ list string Required The identifier of the value list which the created item will be added to.
Returns
Returns a ValueListItem object if creation succeeds.
Response
{ "id": "rsli_1MxxosLkdIwHu7ixxvA1yKiZ", "object": "radar.value_list_item", "created": 1681760074, "created_by": "API", "livemode": false, "value": "1.2.3.4", "value_list": "rsl_1MxxosLkdIwHu7ixNiiD01Kj"}
Retrieve a value list item
GET / v1 / radar / value_list_items /:id
Retrieves a ValueListItem object.
Parameters
No parameters.
Returns
Returns a ValueListItem object if a valid identifier was provided.
Response
{ "id": "rsli_1MxxosLkdIwHu7ixxvA1yKiZ", "object": "radar.value_list_item", "created": 1681760074, "created_by": "API", "livemode": false, "value": "1.2.3.4", "value_list": "rsl_1MxxosLkdIwHu7ixNiiD01Kj"}
List all value list items
GET / v1 / radar / value_list_items
Returns a list of ValueListItem objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
Parameters
- value _ list string Required Identifier for the parent value list this item belongs to.
- value string Return items belonging to the parent list whose value matches the specified value (using an “is like” match). The maximum length is 800 characters.
More parameters
- created object
- ending _ before string
- limit integer
- starting _ after string
Returns
A dictionary with a data property that contains an array of up to limit items, starting after item starting_after. Each entry in the array is a separate ValueListItem object. If no more items are available, the resulting array will be empty.
Response