---
title: "Get agent session"
method: GET
path: "/agent/sessions/{sessionId}"
tags: ["agent"]
---

# Get agent session

`GET /agent/sessions/{sessionId}`

Returns session details including messages and current state.

## Path parameters

- `sessionId` string, required

## Query parameters

- `remoteNode` string

## Response `200`

Session details

- AgentSessionDetailResponse — Session details including messages and current state
  - `messages` AgentMessage[], required
    - `id` string, required
    - `sessionId` string, required
    - `type` 'user' | 'assistant' | 'error' | 'ui_action' | 'user_prompt', required
    - `sequenceId` integer, required
    - `content` string
    - `toolCalls` AgentToolCall[]
      - `id` string, required
      - `type` string, required
      - `function` AgentToolCallFunction, required — Function call details in a tool call
        - `name` string, required
        - `arguments` string, required
    - `toolResults` AgentToolResult[]
      - `toolCallId` string, required
      - `content` string, required
      - `isError` boolean
    - `usage` AgentTokenUsage — Token usage statistics from LLM
      - `promptTokens` integer
      - `completionTokens` integer
      - `totalTokens` integer
    - `cost` number, double
    - `createdAt` string, date-time, required
    - `uiAction` AgentUIAction — UI action to be performed
      - `type` string, required
      - `path` string
    - `userPrompt` AgentUserPrompt — Question from the agent requiring user response
      - `promptId` string, required
      - `question` string, required
      - `options` AgentUserPromptOption[]
        - `id` string, required
        - `label` string, required
        - `description` string
      - `allowFreeText` boolean, required
      - `freeTextPlaceholder` string
      - `multiSelect` boolean, required
      - `promptType` 'general' | 'command_approval'
      - `command` string
      - `workingDir` string
    - `delegateIds` string[]
  - `session` AgentSession, required — Agent chat session metadata
    - `id` string, required
    - `userId` string
    - `dagName` string
    - `title` string
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `parentSessionId` string
    - `delegateTask` string
  - `sessionState` AgentSessionState, required — Current processing state of an agent session
    - `sessionId` string, required
    - `working` boolean, required
    - `hasPendingPrompt` boolean — Whether the agent is waiting for user input
    - `model` string
    - `totalCost` number, double, required — Total accumulated cost in USD
  - `delegates` AgentDelegateSnapshot[]
    - `id` string, required
    - `task` string, required
    - `status` 'running' | 'completed', required
    - `cost` number, double

## Other responses

- `401` — Not authenticated
- `404` — Session not found
- `default` — Unexpected error

## Changes

- **2026-05-24** (v1) `8a2d5d3e9608` — 3 warning
  - added the new `rate_limited` enum value to the `code` response property for the response status `401`
  - added the new `rate_limited` enum value to the `code` response property for the response status `404`
  - added the new `rate_limited` enum value to the `code` response property for the response status `default`
- **2026-04-30** (v1) `50e1d517afc1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/dagucloud/apis/dagu/changes/agent/sessions/:sessionId/get.md)

---

[API](https://skmtc.dev/dagucloud/apis/dagu.md) · [All operations](https://skmtc.dev/dagucloud/apis/dagu/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dagucloud/dagu/revisions/8a2d5d3e9608/schema)