docs: Add documentation for durable execution feature

[inkeep]

Summary

This PR adds documentation for the new durable execution feature introduced in #2615.

Changes

Chat API (agents-docs/content/talk-to-your-agents/chat-api.mdx)

• Added x-workflow-run-id response header documentation for durable mode
• Added tip callout explaining automatic durable execution when agent is configured in durable mode
• Added new "Durable execution mode" subsection under Tool approval explaining how approvals work differently
• Added comprehensive "Durable Executions" section covering:
  • All four executions endpoints (create, get status, reconnect stream, approve tool call)
  • cURL examples for creating executions and reconnecting to streams
  • Execution status response format with status descriptions table
• Updated Development Notes to include /run/api/executions endpoint

Core Concepts (agents-docs/content/concepts.mdx)

• Added new "Execution modes" section explaining:
  • Classic mode (default) - HTTP connection stays open
  • Durable mode - workflow-backed with reconnection support
  • When to use each mode
  • Link to configuration options

Tool Approvals - TypeScript SDK (agents-docs/content/typescript-sdk/tools/tool-approvals.mdx)

• Added note in Runtime Behavior section about durable mode differences
• Added new "Durable execution mode" subsection explaining:
  • How workflow suspends instead of holding connection
  • REST endpoint for approvals (POST /run/api/executions/:executionId/approvals/:toolCallId)
  • cURL examples for approving and denying tool calls
  • Automatic workflow resumption and stream reconnection

Tool Approvals - Visual Builder (agents-docs/content/visual-builder/tools/tool-approvals.mdx)

• Added tip callout in Runtime behavior section about durable mode behavior

Related PR

• Closes documentation for Durable execution #2615 (Durable execution)

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agents-api	Ready	Preview, Comment	Mar 26, 2026 8:26pm
agents-docs	Ready	Preview, Comment	Mar 26, 2026 8:26pm
agents-manage-ui	Ready	Preview, Comment	Mar 26, 2026 8:26pm

[changeset-bot]

⚠️ No Changeset found

Latest commit: e655a08

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR