It is somewhat covered here (in the attached collection I didn’t do a great job at explaining it in the guide itself though) - 1.8 API Introduction
The API documentation also has the embed parameter listed - https://xibo.org.uk/manual/api/#/layout/layoutSearch
I appreciate that it might not be obvious is some cases, we are looking into improving that.
Our oauth2 api library is also under heavy development now, there will be severe changes coming to that as well.
In any case, thank you for your post, I’m sure it will be useful to Xibo community.
If you do have any issues with this or any other API call, please do let me know.