First, thanks for providing the segments API-- lots of great functionality that have made my life a lot easier.
One remaining challenge on my end is parsing the return when I request the definition field, particularly when a segment uses a time-within operator. I noticed that the API seems to now handle within operators, but still fails for after. For the latter, I still receive definition of:
failed converting segment definition: failed converting restriction id
This is in contrast to within, where I now receive e.g.:
name element operator value within.id within.value
1 some_prop [p2] prop2 equals x minutes 1
2 some_prop [p2] prop2 equals x2 <NA> NA
Two main questions:
- Is the functionality of the Segments 1.4 API still a work-in-progress?
- Is there any (ideally regularly updated) documentation that lists the current known limitations/changelog?
Also, is there any way to edit only segment metadata, i.e. an edit method/workaround? It seems that to edit a segment, one must use the Save method-- which means I need to pass in a full body. This can be challenging when the definition is particularly complex, and impossible in the aforementioned scenario when the definition cannot be parsed.
There are times when I have a handful of segments where I simply want to change the name, or perhaps append a description. I can always do this manually, but it'd be convenient to do so programatically, since we've built out quite a bit of plumbing to leverage the API.