---
title: "Query elements with locator strategies"
method: GET
path: "/api/v1/ui/elements"
tags: ["ui"]
---

# Query elements with locator strategies

`GET /api/v1/ui/elements`

Searches the visual tree for elements matching the given locator strategy and value.

## Query parameters

- `strategy` LocatorStrategy, required — unresolved $ref
- `value` string, required
- `limit` integer
- `include` string[]

## Response `200`

Matching elements.

- ElementInfoJson[] — unresolved $ref

## Other responses

- `400` — Invalid selector or locator.
- `409` — Capture is stale or a UI/native mutation or probe is temporarily busy. Retry after obtaining a fresh capture.
- `500` — Internal server error.
- `501` — Capability not implemented by the connected backend.

---

[API](https://skmtc.dev/dotnet/apis/devflow-agent-protocol.md) · [All operations](https://skmtc.dev/dotnet/apis/devflow-agent-protocol/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dotnet/devflow-agent-protocol/revisions/31dec8eed3de/schema)