# App:App Execution

**Page:** api/app-app-execution

[Download Raw Markdown](./api/app-app-execution.md)

---

## API Endpoints Summary

- **GET** `/api/v1/run/search` — Search for app candidates
- **POST** `/api/v1/run/search/paged` — Search for app candidates with cursor pagination
- **POST** `/api/v1/run/preflight` — Preflight a run request
- **POST** `/api/v1/run/batch` — Execute a batch of search or run requests
- **GET** `/api/v1/run/run` — Resolve an application and return exact shell command
- **POST** `/api/v1/run/run` — Resolve an application via JSON body
- **GET** `/api/v1/run/go/{rest}` — Path-based resolve (positional or key-value)
- **GET** `/api/v1/run/t/{terminal_id}/go/{rest}` — Terminal-anchored path-based resolve

## CLI

```bash
# CLI mapping will be generated from the SDK CLI sources in a later step.
# Example (placeholder):
# hoody-cli <command> --help
```