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

# Get Agent Session

`GET /agent/session/{sessionId}`

## Request

- Base URL: `https://api.krea.ai`
- URL: `https://api.krea.ai/agent/session/{sessionId}`
- Auth: HTTP bearer

Read the current status, latest assistant text, and deliverables of a session owned by the caller in the authenticated workspace. Does not wait for completion.

## Path parameters

- `sessionId` string, uuid, required: Session id returned by send_agent_message

## Response `200`

The Agent session result.

- object
  - `sessionId` string, required
  - `threadId` string, required
  - `runId` string
  - `status` 'not_started' | 'running' | 'completed' | 'failed' | 'cancelled', required
  - `finished` boolean, required: True once status is completed, failed, or cancelled
  - `text` string, required: Latest assistant message text
  - `media` object[], required: Media the session produced — the deliverables the agent presented, plus its other generations while a turn is running. Order is not significant. Each item is {jobId, mediaKind?} for a generation (fetch it with get_job), {url} for rehosted media, or {uri, name, mimeType} for a Krea file (read it with read_files)
    - `jobId` string
    - `mediaKind` 'image' | 'video' | 'audio' | '3d'
    - `url` string
    - `uri` string
    - `name` string
    - `mimeType` string
  - `error` string
  - `url` string, required: The session in the Krea app

## Other responses

- `400`: Invalid JSON body.
- `401`: Authentication required.
- `402`: Insufficient compute unit balance or free message limit reached.
- `403`: The requested model is not included in the workspace plan.
- `404`: Session or attachment not found or not accessible.
- `409`: A turn is already in progress.
- `422`: Invalid input or desktop app unavailable.

## Changes

- **2026-10-20** `2424716e5182`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/krea/apis/krea-api/changes/agent/session/:sessionId/get.md)

---

[API](https://skmtc.dev/krea/apis/krea-api.md) · [All operations](https://skmtc.dev/krea/apis/krea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/krea/apis/krea-api/revisions/f503def6ccba?raw)