# Thesys Documentation

## Docs

- [PostMessage Protocol](https://docs.thesys.dev/agent-builder/advanced/postmessage-protocol.md): Low-level postMessage API for communicating with a Thesys agent embedded via iframe.
- [Bring Your Own Identity (BYOI)](https://docs.thesys.dev/agent-builder/byoi.md): Pass your own user identities into a published Thesys agent — each user gets isolated conversation history without needing a Thesys login.
- [Customization](https://docs.thesys.dev/agent-builder/embed-widget/customization.md): Theme the chatbar, set placeholders, and style the widget to match your brand.
- [Events](https://docs.thesys.dev/agent-builder/embed-widget/events.md): Listen to lifecycle events from the embedded agent — thread changes, message flow, tool execution, and errors.
- [Getting Started](https://docs.thesys.dev/agent-builder/embed-widget/getting-started.md): Install the embed widget and add a Thesys agent to your site in under five minutes.
- [Mobile Behavior](https://docs.thesys.dev/agent-builder/embed-widget/mobile-behavior.md): How the embed widget adapts to mobile devices and small viewports.
- [Programmatic Control](https://docs.thesys.dev/agent-builder/embed-widget/programmatic-control.md): Open, close, send messages, and prefill input on the embedded agent from your application code.
- [Widget Types](https://docs.thesys.dev/agent-builder/embed-widget/widget-types.md): Choose between tray, full-screen, and chatbar layouts for your embedded agent.
- [Agent Builder](https://docs.thesys.dev/agent-builder/introduction.md): Build, publish, and embed AI agents — then integrate them into any website or app.
- [Embed](https://docs.thesys.dev/api-reference/endpoints/embed.md): A LLM native endpoint that generates UI.
- [Visualize](https://docs.thesys.dev/api-reference/endpoints/visualize.md): Generates a UI for the given data.
- [Errors](https://docs.thesys.dev/api-reference/errors.md)
- [API Overview](https://docs.thesys.dev/api-reference/getting-started.md)
- [API Changelog](https://docs.thesys.dev/api-reference/model-changelog.md): View changelogs for each API version of C1.
- [Models & Compatibility](https://docs.thesys.dev/api-reference/models-and-compatibility.md)
- [Messages](https://docs.thesys.dev/api-reference/objects/message.md)
- [Streaming Chunks](https://docs.thesys.dev/api-reference/objects/streaming.md)
- [Rate Limits](https://docs.thesys.dev/api-reference/rate-limits.md)
- [Build an AI Financial Data Copilot](https://docs.thesys.dev/examples/analytics-with-c1.md): Learn how to build an AI-powered data copilot with generative UI and real-time financial data
- [Build an AI-Powered Infinite Canvas](https://docs.thesys.dev/examples/canvas-with-c1.md): Learn how to build an infinite canvas with AI-generated visual cards for ideation, planning, and research
- [Company Research Agent](https://docs.thesys.dev/examples/company-research.md): Build a Generative UI Company Research agent using Thesys
- [Example Applications](https://docs.thesys.dev/examples/index.md): End-to-end tutorials showing how to build production-ready AI applications with Thesys C1
- [Build your own ChatGPT-like application](https://docs.thesys.dev/examples/like-chatgpt.md): Integrate images via tool calling to bring your chatbot to life
- [Build an AI Search Engine](https://docs.thesys.dev/examples/search-with-c1.md): Learn how to build a Perplexity-style search app with generative UI using Thesys C1
- [Editing an Artifact in a Conversation](https://docs.thesys.dev/guides/artifacts/artifacts-in-chat/editing.md): A step-by-step tutorial on using a tool call to edit an existing Artifact and embed it in an assistant's response.
- [Generating an Artifact in a Conversation](https://docs.thesys.dev/guides/artifacts/artifacts-in-chat/generating.md): A step-by-step tutorial on using a tool call to create a new Artifact and embed it in an assistant's response.
- [Artifacts in Chat](https://docs.thesys.dev/guides/artifacts/artifacts-in-chat/index.md): Integrate rich, editable documents like reports and slides directly into your C1-powered assistants.
- [Editing Artifacts](https://docs.thesys.dev/guides/artifacts/editing/index.md): Modify existing artifacts through prompt-based instructions or direct manual editing
- [Manual Editing](https://docs.thesys.dev/guides/artifacts/editing/manual.md): Allow users to directly and manually edit the content of generated slides and reports
- [Prompt-Based Editing](https://docs.thesys.dev/guides/artifacts/editing/prompt-based.md): Modify existing artifacts by sending existing artifact back to the API with a new prompt
- [Generating Artifacts](https://docs.thesys.dev/guides/artifacts/generating.md): Call the Artifact API to create new reports and slides from a prompt
- [Artifacts](https://docs.thesys.dev/guides/artifacts/index.md): Generate, render, and edit rich, document-style content like reports and presentations
- [Exporting Artifacts to PDF](https://docs.thesys.dev/guides/artifacts/pdf-export.md): Enable users to download generated reports and slides as PDF files
- [Exporting Slides to PPTX](https://docs.thesys.dev/guides/artifacts/pptx-export.md): Enable users to download generated slides as PPTX files
- [Rendering & Streaming Artifacts](https://docs.thesys.dev/guides/artifacts/rendering.md): Fetch and display artifacts on your frontend with `<C1Component>`, including how to handle a live stream
- [Slide Templates (v-20251230)](https://docs.thesys.dev/guides/artifacts/slides/slide-templates/v-20251230.md): Reference for the available slide templates that can be generated by C1.
- [Slide Templates (v-20260130)](https://docs.thesys.dev/guides/artifacts/slides/slide-templates/v-20260130/index.md): Reference for the slide templates that can be generated by C1
- [Overview](https://docs.thesys.dev/guides/basics.md): The essential guides for making your first API call, rendering UI, and connecting to data.
- [Conversational API](https://docs.thesys.dev/guides/conversational/backend-api.md): Create a conversational API for your application
- [Conversational UI Concepts](https://docs.thesys.dev/guides/conversational/concepts.md): Additional concepts specific to building Chatbot Style interfaces
- [Customising C1Chat](https://docs.thesys.dev/guides/conversational/customizing/c1chat.md): Customise and style your conversational UI components to match your brand
- [Getting Started with <C1Chat>](https://docs.thesys.dev/guides/conversational/getting-started.md): Render a complete chat interface and integrate with your backend
- [Conversational UI](https://docs.thesys.dev/guides/conversational/index.md): Building Generative UI Conversational Apps (like ChatGPT) with Thesys C1
- [Conversation persistence](https://docs.thesys.dev/guides/conversational/persistence.md): Persisting threads and chat history using Firebase
- [Sharing a Single Message](https://docs.thesys.dev/guides/conversational/sharing/message.md): Enable users to generate a shareable link for an individual message.
- [Sharing an Entire Thread](https://docs.thesys.dev/guides/conversational/sharing/thread.md): Let users generate a shareable link for the full conversation thread.
- [UI state management](https://docs.thesys.dev/guides/conversational/state-management.md): Manage the UI state of the chat application using useThreadManager and useThreadListManager
- [Implementing Custom Actions (Buttons)](https://docs.thesys.dev/guides/custom-actions.md): Connect C1-generated UI to your application's specific logic and workflows.
- [Implementing Custom Components](https://docs.thesys.dev/guides/custom-components.md): Provide your own components for the C1 API to render
- [Custom Markdown Responses](https://docs.thesys.dev/guides/custom-markdown-responses.md): Learn how to render custom markdown responses in the C1 UI.
- [Introduction](https://docs.thesys.dev/guides/deployment/introduction.md): Learn how to deploy your C1 application
- [Deploying with Render](https://docs.thesys.dev/guides/deployment/render.md)
- [Deploying with Vercel](https://docs.thesys.dev/guides/deployment/vercel.md)
- [Error Handling](https://docs.thesys.dev/guides/error-handling.md): Pass custom `onError` callback to handle application level errors gracefully
- [Integrating Autogen with Thesys](https://docs.thesys.dev/guides/frameworks/autogen.md): Give your Autogen agents interactive UI components and dynamic workflows powered by Thesys C1
- [Integrating C1 with CopilotKit](https://docs.thesys.dev/guides/frameworks/copilotkit.md): Build Generative UI copilots with CopilotKit & Thesys C1
- [Integrating CrewAI with Thesys](https://docs.thesys.dev/guides/frameworks/crewai.md): Give your CrewAI agents interactive UI components, dynamic workflows, and live dashboards powered by Thesys C1
- [Google ADK Integration](https://docs.thesys.dev/guides/frameworks/google-adk.md): Build conversational AI applications with Google ADK's Python agent framework and C1
- [Frameworks](https://docs.thesys.dev/guides/frameworks/index.md): Integrating C1 into popular Open Source Frameworks
- [LangChain Integration](https://docs.thesys.dev/guides/frameworks/langchain.md): Build powerful AI agents with LangChain and C1 using tools and SQL database integration
- [Integrating Mastra with Thesys](https://docs.thesys.dev/guides/frameworks/mastra.md): Give your Mastra agents interactive UI components and dynamic workflows powered by Thesys C1
- [Building AI powered data apps in Python with Streamlit](https://docs.thesys.dev/guides/frameworks/streamlit.md): Learn how to integrate Streamlit with Thesys to create Generative UI apps, AI-powered dashboards, and interactive interfaces with Python.
- [Integrating C1 with Vercel AI SDK](https://docs.thesys.dev/guides/frameworks/vercel-ai-sdk.md): Build Generative UI applications powered by Vercel AI SDK
- [Guiding UI generations](https://docs.thesys.dev/guides/guiding-outputs.md): Customize UI generations using system prompts
- [How C1 Works](https://docs.thesys.dev/guides/how-c1-works.md): A detailed look at the C1 integration, from the backend API call to UI rendering.
- [AI Coding IDE Setup](https://docs.thesys.dev/guides/ide-setup.md): Configure your IDE to access Thesys documentation for context-aware assistance
- [Integrating C1 in your backend](https://docs.thesys.dev/guides/implementing-api.md): Learn how to invoke the C1 API from your backend using OpenAI library
- [Model Context Protocol (MCP)](https://docs.thesys.dev/guides/integrate-data/mcp.md): Use MCP to extend your agents with custom capabilities
- [Integrate data via Tool Calling](https://docs.thesys.dev/guides/integrate-data/tool-calling.md): Connect your data to the API endpoint to present data-based answers
- [Two-Step Visualize Pattern](https://docs.thesys.dev/guides/integration-pattern/visualize.md): Integrate C1 Visualize API with your existing LLM infrastructure for beautiful UI generation
- [Integration Patterns](https://docs.thesys.dev/guides/integration-patterns.md): How to integrate Generative UI with your existing applications.
- [Actions](https://docs.thesys.dev/guides/interactivity/actions.md): Handling user interactions
- [Forms & Inputs](https://docs.thesys.dev/guides/interactivity/forms.md): Prompt the C1 to generate forms, and how to handle their state and submissions on the frontend.
- [Interactivity](https://docs.thesys.dev/guides/interactivity/index.md): Building dynamic, responsive user experiences by managing client-side state and handling server-side actions.
- [Building Multi-Step Flows](https://docs.thesys.dev/guides/interactivity/multi-step-flows.md)
- [Managing State](https://docs.thesys.dev/guides/interactivity/state.md): How C1 tracks and persists values in generated UIs, enabling forms, inputs, and custom components to work seamlessly.
- [Migrating to Generative UI](https://docs.thesys.dev/guides/migrate-to-genui.md): Integrating Thesys C1 API in an existing application
- [Rendering C1 Responses into live UI](https://docs.thesys.dev/guides/rendering-ui.md): C1 React SDK helps convert C1 API Responses into live UI components on the client side.
- [Response Footer](https://docs.thesys.dev/guides/response-footer.md): Learn how to customize the C1 chat experience by adding a component to the footer of a response.
- [Security & Compliance](https://docs.thesys.dev/guides/security.md): C1 is a hosted service that is built to be secure and compliant.
- [Quickstart](https://docs.thesys.dev/guides/setup.md): Get started quickly with building your first Generative UI application
- [Streaming (Optional)](https://docs.thesys.dev/guides/streaming.md): Improve your application's user experience by streaming C1 responses in real-time.
- [Customizing Charts](https://docs.thesys.dev/guides/styling/charts.md): Control the appearance of charts by defining global and chart-specific color palettes.
- [Overriding Styles with CSS](https://docs.thesys.dev/guides/styling/css-overrides.md): Apply custom CSS for precise, specific style adjustments.
- [Styling](https://docs.thesys.dev/guides/styling/index.md): Customize the appearance of C1-generated UIs to match your application's brand, from broad themes to specific CSS changes.
- [Theming](https://docs.thesys.dev/guides/styling/theming.md): Apply global styles, use presets, and manage light/dark modes with the `<ThemeProvider>`.
- [Thinking States](https://docs.thesys.dev/guides/thinking-states.md): Learn to enhance user experience by updating them about the agent's thinking process in real-time
- [What is C1 by Thesys?](https://docs.thesys.dev/guides/what-is-thesys-c1.md): the Generative UI API for AI-native applications.
- [Display Information](https://docs.thesys.dev/library/display-information.md): Use these components to present static content, visual structure, and supporting context in your UI.
- [Form Elements](https://docs.thesys.dev/library/form-elements.md): Allow users to enter or select values within an interface to gather user intent for the system to respond with relevant actions or information.
- [Component Library](https://docs.thesys.dev/library/index.md): Explore the full set of components supported by C1.
- [Trigger Actions and Control States](https://docs.thesys.dev/library/triggers.md): Allow users to take actions, trigger events, or control states in the interface using these components.
- [Data Visualizaton](https://docs.thesys.dev/library/visualize-data.md): Present quantitative data as various graphic forms based on density and complexity of data.
- [Cooking Assistant](https://docs.thesys.dev/prompt-gallery/cooking-assistant.md): Transform ingredients into customized recipes, with nutritional information and dietary modifications to suit your health goals.
- [Data Visualizer](https://docs.thesys.dev/prompt-gallery/data-visualizer.md): Convert raw data into insightful visualizations with explanations that highlight key trends and patterns for better decision-making.
- [Lawyer On-Call](https://docs.thesys.dev/prompt-gallery/lawyer-on-call.md): Simplify complex legal language into clear explanations, with relevant citations to the original document.
- [Travel Planner](https://docs.thesys.dev/prompt-gallery/travel-planner.md): Create personalized itineraries with local recommendations, accommodation options, and transportation logistics based on your preferences.
- [Chat Component](https://docs.thesys.dev/react-reference/c1-chat.md): React component for building conversational AI interfaces with C1's chat functionality.
- [C1 Component](https://docs.thesys.dev/react-reference/c1-component.md): React component for embedding Generative UI into your applications.
- [Theme Provider](https://docs.thesys.dev/react-reference/theme-provider.md): React component for customizing the C1 UI.
- [C1 Response](https://docs.thesys.dev/sdk-reference/c1-response.md): Server-side helpers for constructing and streaming C1 Response.
- [Community](https://docs.thesys.dev/support/community.md)
- [Productionizing](https://docs.thesys.dev/support/production-checklist.md): Use this checklist to ensure your C1 application is production-ready.
- [Troubleshooting](https://docs.thesys.dev/support/troubleshooting.md): Commonly encountered errors and their solutions

## Optional

- [Developer Tools](https://docs.thesys.dev/developer-tools)
- [AI Coding IDE Setup](https://docs.thesys.dev/guides/ide-setup)
- [Discord](https://discord.gg/Pbv5PsqUSv)
- [Get Support](mailto:support@thesys.dev)