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.
Stop an in-flight session and return it.
stopped_by is recorded only when the caller's credential maps to a GitHub account.
Authorization
HTTPBearer In: header
Path Parameters
Header Parameters
Response Body
application/json
application/json
curl -X POST "https://example.com/v1/sessions/string/stop"{ "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"}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.
Ingest Agent Session Transcript
Append on-disk transcript lines to a session's record — the in-sandbox tailer for interactive sessions. A sandbox token may only push its own session's transcript. Idempotent by transcript line uuid; tolerant of malformed lines.