@scottprigge There's no docs I know of, or could find with a quick search. However, to get you to common frame of reference, if you have the Splunk Dashboard Examples App, then look at the Text Form Input Element example, and note the code and the way the URL behaves.
The xml in the dashboard starts:
<form>
<label>Text Form Input Element</label>
<description>Set search terms by populating a form with textbox input.</description>
<fieldset autoRun="true" submitButton="false">
<input type="text" token="limit" searchWhenChanged="true">
<label>Enter an integer N:</label>
<default>5</default>
</input>
</fieldset>
The token limit is reflected in the URL of your browser as:
https://my.splunk/en-US/app/simple_xml_examples/simple_form_text?form.limit=5
If you change the 5 in the URL (your browser's address bar), to a 10, and hit enter, it will load the dashboard as if 10 was entered into the form already.
The only wrinkle with this is the login timeout. The user has to be authenticated in first, and then can keep using the URL, until their login times out.
... View more