# Fyzz Chat API

> Query Fyzz Chat conversations and projects via the REST API. Use when looking up conversations, searching chat history, or listing projects in Fyzz Chat.

- Skill: `kovrichard/fyzz-chat-api` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add kovrichard/fyzz-chat-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kovrichard/fyzz-chat-api/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: MIT
- Author: kovrichard (https://skillmd.com/u/kovrichard)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kovrichard/fyzz-chat-api

---


When you need to access the user's Fyzz Chat conversations or projects, use the `fyzz-api` CLI tool. The tool reads the API key from the `PAL_FYZZ_API_KEY` environment variable automatically — never attempt to read, print, or reference the API key or the env var directly.

## Available commands

### List conversations

```bash
pal cli skill run fyzz-chat-api fyzz-api -- conversations [--limit 20] [--search "query"] [--project-id <id>] [--cursor <cursor>]
```

### Get a single conversation with messages

```bash
pal cli skill run fyzz-chat-api fyzz-api -- conversations <conversation-id>
```

### List projects

```bash
pal cli skill run fyzz-chat-api fyzz-api -- projects
```

## Setup

If the tool reports a missing API key:

1. Ask the user to create one in Fyzz Chat → Settings → API Keys
2. They should set `PAL_FYZZ_API_KEY` in their shell profile or in PAL's `settings.json` env section
3. Optionally set `PAL_FYZZ_BASE_URL` (defaults to `http://localhost:3000`)

## Guidelines

- The API key is never visible in this conversation — that is by design
- Use `--search` for keyword-based lookup across titles and message content
- Use `--project-id` to scope results to a specific project
- Paginate with `--cursor` using the cursor from the previous response's `meta.cursor` field
- For large conversations, consider whether you need all messages or just the metadata (list mode returns titles only)