---
name: ai-routes
description: Handle 21 OpenAPI operation(s) under /api/v1/ai for the ai route group.
---

# ai API Routes

Handle 21 OpenAPI operation(s) under /api/v1/ai for the ai route group.

Use the generated operation tools to make real API calls. Do not invent API responses.
If a tool reports missing setup, return the exact setup field name to the caller.
For write, update, or delete operations, state the intended action before calling the tool.

## Operations

### api_ai_start_activity_chat_session_api_v1_ai_start_activity_chat_session_post

- Operation ID: `api_ai_start_activity_chat_session_api_v1_ai_start_activity_chat_session_post`
- Route: `POST /api/v1/ai/start/activity_chat_session`
- Mode: WRITE
- Summary: Start activity AI chat session
- Body: JSON request body accepted.

### api_ai_send_activity_chat_message_api_v1_ai_send_activity_chat_message_post

- Operation ID: `api_ai_send_activity_chat_message_api_v1_ai_send_activity_chat_message_post`
- Route: `POST /api/v1/ai/send/activity_chat_message`
- Mode: WRITE
- Summary: Send activity AI chat message
- Body: JSON request body accepted.

### api_ai_start_activity_chat_session_stream_api_v1_ai_stream_start_activity_chat_s

- Operation ID: `api_ai_start_activity_chat_session_stream_api_v1_ai_stream_start_activity_chat_s`
- Route: `POST /api/v1/ai/stream/start/activity_chat_session`
- Mode: WRITE
- Summary: Start activity AI chat session (streaming)
- Body: JSON request body accepted.

### api_ai_send_activity_chat_message_stream_api_v1_ai_stream_send_activity_chat_mes

- Operation ID: `api_ai_send_activity_chat_message_stream_api_v1_ai_stream_send_activity_chat_mes`
- Route: `POST /api/v1/ai/stream/send/activity_chat_message`
- Mode: WRITE
- Summary: Send activity AI chat message (streaming)
- Body: JSON request body accepted.

### api_editor_ai_start_chat_session_stream_api_v1_ai_stream_editor_start_post

- Operation ID: `api_editor_ai_start_chat_session_stream_api_v1_ai_stream_editor_start_post`
- Route: `POST /api/v1/ai/stream/editor/start`
- Mode: WRITE
- Summary: Start editor AI chat session (streaming)
- Body: JSON request body accepted.

### api_editor_ai_send_message_stream_api_v1_ai_stream_editor_message_post

- Operation ID: `api_editor_ai_send_message_stream_api_v1_ai_stream_editor_message_post`
- Route: `POST /api/v1/ai/stream/editor/message`
- Mode: WRITE
- Summary: Send editor AI chat message (streaming)
- Body: JSON request body accepted.

### start_magicblock_session_api_v1_ai_magicblocks_start_post

- Operation ID: `start_magicblock_session_api_v1_ai_magicblocks_start_post`
- Route: `POST /api/v1/ai/magicblocks/start`
- Mode: WRITE
- Summary: Start MagicBlock session (streaming)
- Body: JSON request body accepted.

### iterate_magicblock_session_api_v1_ai_magicblocks_iterate_post

- Operation ID: `iterate_magicblock_session_api_v1_ai_magicblocks_iterate_post`
- Route: `POST /api/v1/ai/magicblocks/iterate`
- Mode: WRITE
- Summary: Iterate MagicBlock session (streaming)
- Body: JSON request body accepted.

### get_session_state_api_v1_ai_magicblocks_session_session_uuid_get

- Operation ID: `get_session_state_api_v1_ai_magicblocks_session_session_uuid_get`
- Route: `GET /api/v1/ai/magicblocks/session/{session_uuid}`
- Mode: READ
- Summary: Get MagicBlock session state
- Parameters:
  - `session_uuid` in `path` required

### start_course_planning_session_api_v1_ai_courseplanning_start_post

- Operation ID: `start_course_planning_session_api_v1_ai_courseplanning_start_post`
- Route: `POST /api/v1/ai/courseplanning/start`
- Mode: WRITE
- Summary: Start course planning session (streaming)
- Body: JSON request body accepted.

### iterate_course_planning_session_api_v1_ai_courseplanning_iterate_post

- Operation ID: `iterate_course_planning_session_api_v1_ai_courseplanning_iterate_post`
- Route: `POST /api/v1/ai/courseplanning/iterate`
- Mode: WRITE
- Summary: Iterate course planning session (streaming)
- Body: JSON request body accepted.

### finalize_course_plan_api_v1_ai_courseplanning_finalize_post

- Operation ID: `finalize_course_plan_api_v1_ai_courseplanning_finalize_post`
- Route: `POST /api/v1/ai/courseplanning/finalize`
- Mode: WRITE
- Summary: Finalize course plan
- Body: JSON request body accepted.

### generate_activity_content_api_v1_ai_courseplanning_generate_activity_post

- Operation ID: `generate_activity_content_api_v1_ai_courseplanning_generate_activity_post`
- Route: `POST /api/v1/ai/courseplanning/generate-activity`
- Mode: WRITE
- Summary: Generate activity content (streaming)
- Body: JSON request body accepted.

### save_activity_content_api_v1_ai_courseplanning_save_activity_content_post

- Operation ID: `save_activity_content_api_v1_ai_courseplanning_save_activity_content_post`
- Route: `POST /api/v1/ai/courseplanning/save-activity-content`
- Mode: WRITE
- Summary: Save AI-generated activity content
- Body: JSON request body accepted.

### get_session_state_api_v1_ai_courseplanning_session_session_uuid_get

- Operation ID: `get_session_state_api_v1_ai_courseplanning_session_session_uuid_get`
- Route: `GET /api/v1/ai/courseplanning/session/{session_uuid}`
- Mode: READ
- Summary: Get course planning session state
- Parameters:
  - `session_uuid` in `path` required

### api_rag_chat_api_v1_ai_rag_chat_post

- Operation ID: `api_rag_chat_api_v1_ai_rag_chat_post`
- Route: `POST /api/v1/ai/rag/chat`
- Mode: WRITE
- Summary: RAG chat (streaming)
- Body: JSON request body accepted.

### api_rag_index_api_v1_ai_rag_index_post

- Operation ID: `api_rag_index_api_v1_ai_rag_index_post`
- Route: `POST /api/v1/ai/rag/index`
- Mode: WRITE
- Summary: Reindex course content for RAG
- Body: JSON request body accepted.

### api_rag_sessions_api_v1_ai_rag_sessions_get

- Operation ID: `api_rag_sessions_api_v1_ai_rag_sessions_get`
- Route: `GET /api/v1/ai/rag/sessions`
- Mode: READ
- Summary: List RAG chat sessions
- Parameters:
  - `org_slug` in `query`

### api_rag_session_messages_api_v1_ai_rag_sessions_aichat_uuid_messages_get

- Operation ID: `api_rag_session_messages_api_v1_ai_rag_sessions_aichat_uuid_messages_get`
- Route: `GET /api/v1/ai/rag/sessions/{aichat_uuid}/messages`
- Mode: READ
- Summary: Get RAG chat session messages
- Parameters:
  - `aichat_uuid` in `path` required

### api_rag_session_delete_api_v1_ai_rag_sessions_aichat_uuid_delete

- Operation ID: `api_rag_session_delete_api_v1_ai_rag_sessions_aichat_uuid_delete`
- Route: `DELETE /api/v1/ai/rag/sessions/{aichat_uuid}`
- Mode: WRITE
- Summary: Delete a RAG chat session
- Parameters:
  - `aichat_uuid` in `path` required

### api_rag_session_update_api_v1_ai_rag_sessions_aichat_uuid_patch

- Operation ID: `api_rag_session_update_api_v1_ai_rag_sessions_aichat_uuid_patch`
- Route: `PATCH /api/v1/ai/rag/sessions/{aichat_uuid}`
- Mode: WRITE
- Summary: Update a RAG chat session
- Parameters:
  - `aichat_uuid` in `path` required
- Body: JSON request body accepted.