learnhouse-agent/skills/ai/SKILL.md

name, description

name	description
ai-routes	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.