Replay Agent Session
Re-run an existing run's trigger input as a new run. Reuses the original config snapshot unless config_id is given, and accepts the same config_override as session start — e.g. {"claude": {"model": ...}} to replay the same input on a different model.
Re-run an existing run's trigger input as a new run.
Reuses the original config snapshot unless config_id is given, and accepts the same config_override as session start — e.g. {"claude": {"model": ...}} to replay the same input on a different model.
Authorization
HTTPBearer In: header
Path Parameters
Header Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Parameters for re-running an existing run's original trigger input as a new run.
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/sessions/string/replay" \ -H "Content-Type: application/json" \ -d '{}'{ "agent_config_id": "string", "attributed_user": { "avatar_url": "string", "id": 0, "login": "string", "type": "User" }, "attribution_id": "string", "attribution_type": "github_user", "client_version": "string", "config_override": {}, "context_repository": "string", "cost_fee": 0, "cost_sandbox_cpu": 0, "cost_sandbox_memory": 0, "cost_tokens": 0, "created_at": "2019-08-24T14:15:22Z", "customer_id": "string", "default_resolution": "repo_default", "exit_status": "completed", "harness": "claude_code", "id": "string", "last_activity_at": "2019-08-24T14:15:22Z", "last_message_at": "2019-08-24T14:15:22Z", "live_summary": "string", "metadata": {}, "output_prs": [ { "gh_pr_id": 0, "number": 0, "repo_full_name": "string", "title": "string", "url": "string" } ], "parent_agent_session_id": "string", "parent_kind": "continuation", "prompt": "string", "prompting": { "blocked_reason": "mention_surface", "detail": "string", "enabled": true, "surface_name": "string" }, "replayed_from_session_id": "string", "resolved_budget_cents": 0, "resolved_budget_source": "system", "sandbox_id": "string", "session_key": "string", "session_state": "idle", "source": "react", "status": "scheduled", "status_reason": "string", "stopped_at": "2019-08-24T14:15:22Z", "stopped_by": 0, "stopped_by_user": { "avatar_url": "string", "id": 0, "login": "string", "type": "User" }, "surface": { "run": "scheduled", "session": "alive", "status": "string" }, "tokens_cache_creation": 0, "tokens_cache_read": 0, "tokens_input": 0, "tokens_model": "string", "tokens_output": 0, "tokens_total": 0, "updated_at": "2019-08-24T14:15:22Z", "webhook_id": "string", "webhook_type": "github.issue"}Get Agent Session Records
Return the session's stored transcript records. Pagination is opt-in (after_seq/limit — the same feed_seq cursor as the stream); a bare call returns the full retained transcript. Available to sandbox tokens too: an agent answering "did X look into Y?" needs to read the session it found via /sessions/search, and any org member sees the same transcript in the dashboard (laptop transcripts are redacted client-side before they are ever uploaded).
Stop Agent Session
Stop an in-flight session and return it. stopped_by is recorded only when the caller's credential maps to a GitHub account.