Using ?layout= on GET /search

[noahvp8]

Hi there - I would like to specify an existing layout (saved via the BH UI) for a search request. I see the docs here http://bullhorn.github.io/rest-api-docs ... get-search that say that I can use either ?fields= or ?layout=, but when I try to use ?layout=API_Opp_Report, I get an error back:
{
"errorMessage": "Unknown layout:API_Opp_Report",
"errorCode": 400
}

Is this syntax correct? Should I be able to access a layout saved in the UI this way?

[tluczak]

You can use the layout to grab the settings against a respective entity for example see this call below:

GET rest-services/[redacted]/meta/JobOrder?layout=ListRow&BhRestToken[redacted]


For example if you ran:
rest-services/[redactred]/meta/Candidate?fields=*

The "names" pulled back can be inserted in place of the your example "API_Opp_Report".