# Button

## Invoke a Script with a Button

You can invoke a script with a button. This will allow you to specify arguments, environment and run as credentials for the script. 

Set the target of the button to script and select the script you would like to use. You can then select the environment and run as credentials. Finally, specify parameters to pass to the script. 

![](/files/-Mj0V4sJjwO-XPjhX8_n)

Clicking the button will run the script and show a toast notification after the click. 

![](/files/-Mj0VNxUfEAajQUP2jHn)

## Invoke an API with a Button

Set the target to API and select the endpoint that you want to invoke. The endpoint must be a POST endpoint. Parameters can be specified. Parameters will be passed as part of a JSON object. 

![](/files/-Mj0Vi8hTgPonCq9dtCf)

## Customize the Button 

Buttons support customizing the text and icon shown within the button.

![](/files/-Mj0WmGMZ51b0zhFIg4Z)

## Properties

| Property         | Description                                                                                                                    | Available Since |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------ | --------------- |
| Id               | The ID of this component                                                                                                       | 2.2.0           |
| Target Type      | The type of target. Supports Script and API.                                                                                   | 2.2.0           |
| Target           | The script or API to invoke.                                                                                                   | 2.2.0           |
| Run As           | The run as credential to use when invoking a script. Not used for APIs.                                                        | 2.2.0           |
| Environment      | The environment to run the script within. Not used for APIs.                                                                   | 2.2.0           |
| Parameters       | Name value pairs of parameters. For scripts, they are passed as parameters. For APIs, they are passed as a single JSON object. | 2.2.0           |
| Text             | The text to display within the button                                                                                          | 2.2.0           |
| Icon             | The icon to display within the button                                                                                          | 2.2.0           |
| Toast on Success | Shows a success toast message when the button successfully calls the target.                                                   | 2.2.0           |
| Toast on Error   | Shows a failure toast message when the button fails to call the target.                                                        | 2.2.0           |
|                  |                                                                                                                                |                 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.powershelluniversal.com/master-1/userinterfaces/pages/button.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.