Agent Zero provides external API endpoints for integration with other applications.

These endpoints use API key authentication and support text messages and file attachments.

#### API Token Information

The API token is automatically generated from your username and password. This same token is used for both MCP server connections and external API endpoints. The token changes when you update your credentials.

## POST /api_message

Send messages to Agent Zero and receive responses. Supports text messages, file attachments, and conversation continuity.

### API Reference

Parameters:
• `context_id` (string, optional): Existing chat context ID
• `message` (string, required): The message to send
• `attachments` (array, optional): Array of {filename, base64} objects
• `lifetime_hours` (number, optional): Chat lifetime in hours (default: 24)
• `project_name` (string, optional): Project name to activate (only on first message)

Headers: `X-API-KEY` (required), `Content-Type: application/json`

### JavaScript Examples

#### Basic Usage Example

#### Conversation Continuation Example

#### File Attachment Example

#### Project Usage Example

## GET/POST /api_log_get

Retrieve log data by context ID, limited to a specified number of entries from the newest.

### API Reference

Parameters:
• `context_id` (string, required): Context ID to get logs from
• `length` (integer, optional): Number of log items to return from newest (default: 100)

Headers: `X-API-KEY` (required), `Content-Type: application/json` (for POST)

### JavaScript Examples

#### GET Request Example

#### POST Request Example

## POST /api_terminate_chat

Terminate and remove a chat context to free up resources. Similar to the MCP finish_chat function.

### API Reference

Parameters:
• `context_id` (string, required): Context ID of the chat to terminate

Headers: `X-API-KEY` (required), `Content-Type: application/json`

### JavaScript Examples

#### Basic Termination Examples

## POST /api_reset_chat

Reset a chat context to clear conversation history while keeping the context_id alive for continued use.

### API Reference

Parameters:
• `context_id` (string, required): Context ID of the chat to reset

Headers: `X-API-KEY` (required), `Content-Type: application/json`

### JavaScript Examples

#### Basic Reset Examples

## POST /api_files_get

Retrieve file contents by paths, returning files as base64 encoded data. Useful for retrieving uploaded attachments.

### API Reference

Parameters:
• `paths` (array, required): Array of file paths to retrieve (e.g., ["/a0/usr/uploads/file.txt"])

Headers: `X-API-KEY` (required), `Content-Type: application/json`

### JavaScript Examples

#### File Retrieval Examples