Skip to main content
For AI agents: a documentation index is available at https://docs.parallel.ai/llms.txt. The full text of all docs is at https://docs.parallel.ai/llms-full.txt. You may also fetch any page as Markdown by appending .md to its URL or sending Accept: text/markdown.

Overview

Interactions let you chain context between API calls. Each response includes an interaction_id, which you can pass as previous_interaction_id in a subsequent request to carry forward the context from the previous call. This enables multi-turn research workflows like follow-up questions, iterative refinement, and conversational agents. Interactions work across both the Task API and Chat API.

How It Works

  1. Make an initial request — the response includes an interaction_id
  2. Pass it forward — include that value as previous_interaction_id in your next request
  3. Continue the chain — each new response returns its own interaction_id, so you can keep building on prior context
Diagram of multi-turn interactions chaining context across API calls

Request and Response Fields

These fields are available on both Task API (BetaTaskRunInput) and Chat API (ChatCompletionRequest) requests, and their corresponding responses.

Task API Usage

Cross-Processor Interactions

You can chain interactions across different processors of the Task API.
Interactions are not available for Zero Data Retention (ZDR) customers.

Next Steps