---
title: "Warmup"
method: POST
path: "/assistant/warmup"
tags: ["assistant"]
---

# Warmup

`POST /assistant/warmup`

Warm up the assistant for a project, logstream or experiment.

Call this when the user opens the assistant panel, before they send their first message.
Returns 204. Safe to call multiple times.

## Request body

- WarmupRequest — Request body for warming up the assistant.
  - `context` union[] — Active surfaces to pre-fetch context for. Logstream and experiment items trigger schema prefetch; other types are ignored.
    - union
      - PageContext — Current application page for the assistant turn.
        - `type` 'page', required
        - `id` string, required — Page identifier.
        - `path` string, required — Current route path.
        - `view` string, nullable — Optional page view or sub-view identifier.
      - ProjectContext — Active project scope for the assistant turn.
        - `type` 'project', required
        - `id` string, uuid4, required — Project ID.
      - LogstreamContext — Active logstream scope for the assistant turn.
        - `type` 'logstream', required
        - `id` string, uuid4, required — Logstream (run) ID.
        - `project_id` string, uuid4, required — Project the logstream belongs to.
        - `start_time` string, date-time, nullable — Start of the active time window (UTC).
        - `end_time` string, date-time, nullable — End of the active time window (UTC).
      - ExperimentContext — Active experiment scope for the assistant turn.
        - `type` 'experiment', required
        - `id` string, uuid4, required — Experiment ID.
        - `project_id` string, uuid4, required — Project the experiment belongs to.
        - `start_time` string, date-time, nullable — Start of the active time window (UTC).
        - `end_time` string, date-time, nullable — End of the active time window (UTC).
      - TraceContext — A specific trace the user is viewing.
        - `type` 'trace', required
        - `id` string, uuid4, required — Trace ID.
        - `project_id` string, uuid4, required — Project the trace belongs to.
      - SpanContext — A specific span within a trace the user is viewing.
        - `type` 'span', required
        - `id` string, uuid4, required — Span ID.
        - `trace_id` string, uuid4, required — Trace the span belongs to.
        - `project_id` string, uuid4, required — Project the trace belongs to.

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-26** `05003e7835a2` — 3 info
  - the endpoint scheme security `ClassicAPIKeyHeader` was added to the API
  - added `page` discriminator mapping keys to the `context/items/` request property
  - added `#/components/schemas/PageContext` to the `context/items/` request property `oneOf` list

[Change history](https://skmtc.dev/galileo/apis/galileo-api-server/changes/assistant/warmup/post.md)

---

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