---
title: "Changes to Hand this session's context to another agent [write]"
method: POST
path: "/sessions/{id}/handoff"
---

# Changes to Hand this session's context to another agent [write]

`POST /sessions/{id}/handoff`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 4 revisions.

- **2026-11-02** `e5e8f0229a99`: 1 breaking, 6 info

## Changes

- **2026-11-02** `e5e8f0229a99`: 1 breaking, 6 info
  - added the new required `header` request parameter `Idempotency-Key`
  - added the new optional request property `llm`
  - added the new optional request property `reasoningEffort`
  - added the optional property `error/request_id` to the response with the `default` status
  - added the optional property `handoff/hands` to the response with the `202` status
  - added the optional property `handoff/workspace_carried` to the response with the `202` status
  - added the optional property `handoff/workspace_folder` to the response with the `202` status

---

[Operation](https://skmtc.dev/agentsky/apis/agentsky-developer-api/docs/sessions/:id/handoff/post.md) - [API](https://skmtc.dev/agentsky/apis/agentsky-developer-api.md) - [Page](https://skmtc.dev/agentsky/apis/agentsky-developer-api/changes/sessions/:id/handoff/post)