---
title: "Continue or fork a session"
method: POST
path: "/sessions/{id}/continue"
tags: ["Sessions"]
---

# Continue or fork a session

`POST /sessions/{id}/continue`

Create a new session that continues from an existing session,
inheriting its conversation history.

## Path parameters

- `id` string, required

## Request body

- ContinueSessionRequest
  - `query` string, required — New query to continue with
  - `system_prompt` string — Override system prompt
  - `append_system_prompt` string — Append to system prompt
  - `mcp_config` MCPConfig
    - `mcpServers` object — Map of server name to configuration
  - `permission_prompt_tool` string — MCP tool for permissions
  - `allowed_tools` string[] — Allowed tools list
  - `disallowed_tools` string[] — Disallowed tools list
  - `custom_instructions` string — Custom instructions
  - `max_turns` integer — Max conversation turns

## Response `201`

New session created

- ContinueSessionResponse
  - `data` object, required
    - `session_id` string, required
    - `run_id` string, required
    - `claude_session_id` string, required
    - `parent_session_id` string, required

## Other responses

- `404` — Resource not found
- `500` — Internal server error

## Changes

- **2025-08-20** `8656adc5d26d` — 4 info
  - added the new optional request property `mcp_config/mcpServers/additionalProperties/headers`
  - added the new optional request property `mcp_config/mcpServers/additionalProperties/type`
  - added the new optional request property `mcp_config/mcpServers/additionalProperties/url`
  - the request property `mcp_config/mcpServers/additionalProperties/command` became optional
- **2025-08-15** `2c81d2a8d772` — 1 breaking, 3 warning
  - the request property `mcp_config/mcpServers/additionalProperties/command` became required
  - removed the request property `mcp_config/mcpServers/additionalProperties/headers`
  - removed the request property `mcp_config/mcpServers/additionalProperties/type`
  - removed the request property `mcp_config/mcpServers/additionalProperties/url`
- **2025-08-14** `ce345243c995` — 4 info
  - added the new optional request property `mcp_config/mcpServers/additionalProperties/headers`
  - added the new optional request property `mcp_config/mcpServers/additionalProperties/type`
  - added the new optional request property `mcp_config/mcpServers/additionalProperties/url`
  - the request property `mcp_config/mcpServers/additionalProperties/command` became optional
- …earlier changes not shown

[Full history](https://skmtc.dev/humanlayer/apis/humanlayer-daemon-rest-api/changes/sessions/:id/continue/post.md)

---

[API](https://skmtc.dev/humanlayer/apis/humanlayer-daemon-rest-api.md) · [All operations](https://skmtc.dev/humanlayer/apis/humanlayer-daemon-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humanlayer/humanlayer-daemon-rest-api/revisions/02da8cb8aa12/schema)