# Agent:Sessions

**Page:** api/agent-sessions

[Download Raw Markdown](./api/agent-sessions.md)

---

## API Endpoints Summary

- **GET** `/api/v1/workspaces/{workspaceID}/sessions` — List workspace sessions
- **POST** `/api/v1/workspaces/{workspaceID}/sessions` — Create workspace session
- **GET** `/api/v1/workspaces/{workspaceID}/sessions/status` — Get all workspace session statuses
- **GET** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}` — Get workspace session
- **PATCH** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}` — Update workspace session
- **DELETE** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}` — Delete workspace session
- **GET** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/children` — Get child sessions
- **GET** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/messages` — List workspace session messages
- **GET** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/messages/{messageID}` — Get workspace session message
- **GET** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/summary` — Get workspace session summary
- **GET** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/diff` — Get workspace session diff
- **GET** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/todo` — Get workspace session todos
- **POST** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/abort` — Abort workspace session
- **POST** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/fork` — Fork workspace session
- **POST** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/revert` — Revert workspace session message
- **POST** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/unrevert` — Unrevert workspace session
- **POST** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/init` — Initialize workspace session config
- **POST** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/export` — Export session (workspace)
- **POST** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/message` — Send message
- **POST** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/prompt_async` — Send async message
- **POST** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/command` — Send command
- **POST** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/shell` — Run shell command
- **POST** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/summarize` — Summarize session
- **PATCH** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/tags` — Update session tags
- **PATCH** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/message/{messageID}` — Update message
- **PATCH** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/message/{messageID}/part/{partID}` — Update message part
- **DELETE** `/api/v1/workspaces/{workspaceID}/sessions/{sessionID}/message/{messageID}/part/{partID}` — Delete message part
- **GET** `/api/v1/agent/sessions/live` — Sessions wall (HTML)
- **GET** `/api/v1/agent/all` — Sessions wall (alias)

## CLI

```bash
# CLI mapping will be generated from the SDK CLI sources in a later step.
# Example (placeholder):
# hoody-cli <command> --help
```