Hey @nateiler !
Great question. First, I want to make sure you realize it’s optional, and you don’t need to define it.
As you can see from that documentation, it’s code that goes and gets a single example of that resource from the API. Most APIs, of course, provide this functionality to retrieve one specific item, usually by that item’s ID.
It’s useful in terms of Zapier’s platform in two places:
- When a search only returns a small set of data from the objects returned, it would go get the full object
- Similarly, after creating an object it would get used to return the full object if, for example, the POST did not return the entirety of the object
Since many APIs aren't 100% consistent in the data/fields that are returned by those two possibilities, we always perform a "get" afterwards, so that we then guarantee the same/consistent data is returned.Thus:
- search-success -> get
- create-success -> get
Hope that clears that up. Let us know if you have any more questions!
Thanks @shalgrim!
Understanding the GET calls are happening in the background after those operations occur is exactly what I was wanting to understand.