Invokes (clicks) a UI element using the Windows Automation API. This endpoint provides a more reliable way to interact with UI elements compared to simulating mouse clicks, as it uses the native Windows accessibility framework.
This endpoint is the preferred method for interacting with UI elements in Windows applications when you have the element's ID.
Important: The element ID must be obtained from either the System Overview
or Get Automation Details endpoints. The ID corresponds
to the Id property of UI elements found in these responses.
Before using this endpoint, ensure that:
SupportsInvoke property)This endpoint requires a single parameter: the ID of the UI element to invoke.
| Property | Type | Description |
|---|---|---|
elementId Required |
String | The composite identifier of the UI element to invoke. This ID can be found in the System Overview or Automation Details responses. |
{
"elementId": "W-Notepad|B-File"
}The endpoint returns a simple response object indicating whether the operation was successful.
| Property | Type | Description |
|---|---|---|
success |
Boolean | Indicates whether the operation was successful. |
message |
String | A message describing the result of the operation. |
{
"success": true,
"message": "Click executed (using Windows Automation)"
}{
"success": false,
"message": "Element not found"
}
Note: If you attempt to use this endpoint with an HTML element in a Chrome browser, you'll receive an error message instructing you to use Chrome-specific actions like chromeClickElement instead.
SupportsInvoke property in the element details to check if an element supports this operation.import requests
import json
# API configuration
BASE_URL = "http://localhost:54321"
API_KEY = "your-api-key" # Replace with your actual API key
# Headers
headers = {
"Content-Type": "application/json",
"Authorization": f"Bearer {API_KEY}"
}
# Invoke a UI element
def invoke_element(element_id):
url = f"{BASE_URL}/tools-api/automation/invoke"
payload = {
"elementId": element_id
}
response = requests.post(url, headers=headers, json=payload)
if response.status_code == 200:
return response.json()
else:
print(f"Error: {response.status_code}")
print(response.text)
return None
# Example usage
element_id = "W-Notepad|B-File" # Example element ID
result = invoke_element(element_id)
print(json.dumps(result, indent=2))import axios from 'axios';
// API configuration
const BASE_URL = 'http://localhost:54321';
const API_KEY = 'your-api-key'; // Replace with your actual API key
// Headers
const headers = {
'Content-Type': 'application/json',
'Authorization': `Bearer ${API_KEY}`
};
// Invoke a UI element
async function invokeElement(elementId: string): Promise {
try {
const url = `${BASE_URL}/tools-api/automation/invoke`;
const payload = {
elementId: elementId
};
const response = await axios.post(url, payload, { headers });
return response.data;
} catch (error) {
console.error('Error invoking element:', error);
throw error;
}
}
// Example usage
(async () => {
try {
const elementId = 'W-Notepad|B-File'; // Example element ID
const result = await invokeElement(elementId);
console.log(JSON.stringify(result, null, 2));
} catch (error) {
console.error('Operation failed:', error);
}
})(); using System;
using System.Net.Http;
using System.Text;
using System.Text.Json;
using System.Threading.Tasks;
class Program
{
// API configuration
private const string BaseUrl = "http://localhost:54321";
private const string ApiKey = "your-api-key"; // Replace with your actual API key
private static readonly HttpClient client = new HttpClient();
static async Task Main(string[] args)
{
// Example element ID
string elementId = "W-Notepad|B-File";
var result = await InvokeElement(elementId);
Console.WriteLine(JsonSerializer.Serialize(result, new JsonSerializerOptions { WriteIndented = true }));
}
static async Task