---
title: "Java API Reference Code Agent SDK"
source: https://docs.autohand.ai/agent-sdk/java-api
---

# Java API Reference

Complete API reference for the Autohand SDK Java. The SDK spawns the Autohand CLI as a subprocess and communicates over JSON-RPC.

## Installation

Add the dependency to your `pom.xml`:

## High-Level API

### Agent

#### Agent Methods

### Run

## Low-Level API

### AutohandSDK

#### Key Methods

## Example Reference

Source-backed examples pulled from `/agentsdk/tin-wrapper/java/examples`.

## Events

Events are delivered through a `Consumer<Event>` callback. Key types:

-   `MessageUpdateEvent` - Streaming assistant text delta
-   `ToolStartEvent` - Tool execution started
-   `ToolEndEvent` - Tool execution completed
-   `PermissionRequestEvent` - Runtime pause for approval
-   `ErrorEvent` - Error occurred

## Error Handling

The SDK uses structured exceptions:

## See Also

-   [Java SDK Overview](java.html)
-   [CLI Quick Start](../guides/cli-quick-start.html)