Documentation

Conversations

Conversations

Promptmark now has a built-in conversation interface. Chat with AI models, stream responses in real time, import your existing chat history, and connect conversations to prompts from your library.

What’s new

  • Multi-turn conversations — Persistent chat threads with full message history. Pick up where you left off, search across conversations, and filter by source or model.
  • Real-time streaming — AI responses stream token by token via SSE, with live token counting as the response arrives.
  • Multi-model support — Switch between AI providers and models. Works with OpenRouter and direct connections to OpenAI and Anthropic (via Bring Your Own Key).
  • Import your chats — Bring in conversations from ChatGPT exports, Claude exports, generic JSON, and markdown files. A 2-step preview-and-confirm flow lets you review before importing.
  • Export conversations — Download any conversation as Claude or ChatGPT JSON format for portability.
  • Prompt linking — Link a conversation to a prompt from your library. The prompt content is injected as a system prompt, so you can iterate on prompts in a live conversation context.
  • Token and cost tracking — Input and output token counts recorded for every message, with model and provider metadata.
  • Search and filtering — Full-text search across conversation titles, filtering by source format, and paginated results.
  • Keyboard shortcut — Press Alt+H to jump to Conversations from anywhere.

For API integrators

Nine MCP tools for managing conversations through AI assistants:

Tool Description
list_conversations List conversations with optional search and source filtering
get_conversation Get a conversation by ID with optional messages
create_conversation Create a new conversation with a model and optional system prompt
update_conversation Update conversation metadata (title, model, linked prompt, system prompt)
delete_conversation Delete a conversation (soft delete)
send_message Send a message and get the AI response. Requires an API key in Settings
import_conversation Import a conversation with messages from an external source
list_conversation_messages List messages with cursor-based pagination for large threads
link_conversation_prompt Link a conversation to a prompt for system prompt injection
Info
The send_message tool supports all three providers (OpenRouter, OpenAI, Anthropic). It automatically routes to the best available key for the selected model.