---
title: "Create Session"
method: POST
path: "/assistant/sessions"
---

# Create Session

`POST /assistant/sessions`

## Request

- Base URL: `https://api.retrodiffusion.ai/v2`
- URL: `https://api.retrodiffusion.ai/v2/assistant/sessions`
- Auth: none declared. Required headers: `X-RD-Token`

Start an assistant session (5-minute idle expiry; keepalive extends).

## Headers

- `X-RD-Token` string, required

## Request body

- AssistantSessionCreateRequest
  - `settings` AssistantSessionSettings
    - `auto_approve_budget_usd` number

## Response `200`

Successful Response

- AssistantSessionRead
  - `id` string, required
  - `status` string, required
  - `settings` object
  - `message_count` integer
  - `spent_usd` number
  - `bank` AssistantBankImageRead[]
    - `ref` string, required
    - `url` string, required
    - `format` string, required
    - `width` integer
    - `height` integer
    - `desc` string
    - `source` string
    - `transparent` boolean
    - `inference_id` string
    - `asset_id` string
  - `pending_plan` object
  - `active_turn_id` string
  - `expires_at` string, date-time
  - `created_at` string, date-time

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `405`: Method not allowed.
- `422`: Validation Error
- `500`: Internal Server Error

---

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