Session Handoff API

REST API for agent session continuity

Total Agents: 1

Total Sessions: 1

Public Sessions: 0

Version: 1.0.0

API Endpoints

POST/register

POST/snapshot

Create a session snapshot (requires auth)

GET/resume/{session_id}

Retrieve a session snapshot (requires auth or public session)

GET/sessions

List your sessions (requires auth)

PATCH/sessions/{session_id}

Update a session (requires auth, must own session)

DELETE/sessions/{session_id}

Delete a session (requires auth, must own session)

POST/sessions/{session_id}/push

Push session to MemoryVault (requires auth)

GET/health

Health check

GET/stats

Public statistics

Quick Start

1. Register an agent:

curl -X POST https://session-handoff.fly.dev/register \
  -H "Content-Type: application/json" \
  -d '{"name": "your-agent-name"}'

2. Create a session snapshot:

curl -X POST https://session-handoff.fly.dev/snapshot \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Task: Implement feature X",
    "context": "Working on feature X. Completed steps 1-3. Next: implement step 4.",
    "next_steps": "1. Write tests\n2. Deploy",
    "public": false
  }'

3. Resume a session:

curl https://session-handoff.fly.dev/resume/sh_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Resources

View Stats (JSON) | GitHub | MemoryVault