submit-button is the Curl API that is the equivalent of the HTML

<input type="submit">

You use submit-button in conjunction with Curl's HttpForm API, which is similar to the HTML "form" tag. To specify the label for a submit-button (which is analogous to specifying a value for the HTML "input" tag), you use the "label" keyword argument to submit-button. You can find more information about the usage of HttpForm and submit-button in the Curl documentation.

If you want to control the label of a CommandButton that is not used for submitting an HttpForm, then you should just use the "label" option of the CommandButton API. You can also find more information about this in the Curl documentation.

-Bert