---
title: "Ask Session"
method: POST
path: "/studio/ask"
tags: ["AI_STUDIO"]
---

# Ask Session

`POST /studio/ask`

## Request

- Base URL: `https://api.myaltimate.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myaltimate.com/studio/ask`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Ask a question in an AI playground session and get streaming response.

The actual pipeline (security scan, output guard, service invocation,
streaming) lives in ``app.service.ai_playground.ask_pipeline.run_ask_pipeline``
so it can be reused by the playground scheduler worker without an HTTP
callback. This endpoint is now a thin transport wrapper.

## Query parameters

- `navigationSource` string, nullable

## Request body

- SessionAskRequest
  - `message` string, required
  - `context` Context, required
    - `connections` object, nullable
    - `knowledge` string[], nullable
    - `uploaded_files` UploadedFile[], nullable
      - `filename` string, required
      - `content` string, required
      - `content_type` string, required
      - `size` integer, required
    - `notifications` object[], nullable
  - `session_id` string, required
  - `mode` string, required
  - `datamates` integer[], nullable
  - `prompt_label` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-30** `a1870d258a3a`: 1 info
  - added the new optional request property `prompt_label`

[Operation history](https://skmtc.dev/myaltimate/apis/myaltimate-api/changes/studio/ask/post.md)

---

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