JSON API » menus » menus/available/list

Gets the fields of all menus visible to the user. To reduce database load, data is cached for up to one minute.

Input parameters

Requires authentication and the user role privilege.

NameTypeDescriptionRequiredDefault value
auth_usernameStringAuthentication username.Yes
auth_passwordStringAuthentication password.Yes
languageStringLanguage code.NoDefault language.
nestedInteger1 to return sub-menus as nested children of their parent menus, 0 to return a flat array.No0

Responses

CodeDescription
200Success.
401The authentication details provided are invalid.
402Your role does not allow this.

Data returned

An array of fields, corresponding to the rows of the menus table in the database.

Example: With required parameters

http://enswitch.example.com/api/json/menus/available/list/?auth_username=user;auth_password=password

{ "responses":[ { "code":"200", "key":"", "message":"OK" } ], "data":[ { "id":1, "name":"example1", ... }, { "id":2, "name":"example2", ... } ] }

Change history

VersionChanges
3.13Function added.