Establishes and manages a WebSocket connection for real-time communication.


Handle WebSocket Connection


APIError

Storytell.ai

10x yourself and your team with our Collaborative Intelligence Platform

Welcome to Storytell

Gain realtime actionable insights from your knowledge

Dynamic Insights™

To Make Life Meaningful by Making Work Meaningful

Our Purpose

Our Commitments to You

Help shape the future direction of Storytell

Early Access to New Features 

Most of what makes Storytell special is out of sight, out of mind

Introduction

Built for speed

LLM Router

A Story Tile™ is comprised of clusters of closely related concepts sourced from your uploaded files that enable Storytell to deliver accurate and relevant responses.

Story Tiles™

Include or exclude external knowledge from your chats

Public Knowledge

Storytell transforms CSV data into Story Tiles™, enabling powerful insights and analysis through our advanced LLM processing pipeline.

Working with XLS or CSV files

Ingrgrate Storytell.ai with your workflow

Utilize Storytell APIs and SDKs to build Storytell into your workflows and user experiences

Interface with Storytell via API or SDKs

Upload your assets, connect to cloud storage or use your AI agent

Connect your assets to Storytell

Give your users access to our advanced AI chat functionality

Adding our AI Chat layer

Creates any missing user snapshots by analyzing gaps in historical snapshot data and regenerating them automatically.


Heal Missing User Snapshots


A health check that ensures user snapshots are always current.


Repair Missing User Data


Health Check


Creates dummy identifiers to support automated code generation processes.


Generate Placeholder IDs


A utility structure that exists solely to support API code generation templates and infrastructure.


Placeholder Struct for Server Generation


A utility structure that exists solely to support API code generation templates and content type definitions.


Placeholder Struct for Thread Content Types


Internal endpoint for file processing services to report status changes during asset processing.


Update Asset Processing State


Modifies metadata and configuration attributes associated with an existing asset.


Update Asset Properties


Creates a new asset record and returns a signed URL for secure file upload to cloud storage.


Initialize New Asset Upload


Triggers asset fingerprinting and indexing after upload completion, making the asset available for chat.


Register Uploaded Asset


Finds and returns assets that match the provided name search criteria.


Search Assets by Name


Performs a soft delete operation on multiple assets, hiding them from queries but retaining data for potential recovery. Recovery window varies based on organization retention policy.


Delete Assets (Recoverable)


Retrieves asset information if the user has read permissions in any collection containing the asset.


Get Asset Details


Grants user permissions by validating and consuming an unclaimed access token, requiring authentication.


Redeem Access Token


Returns sorted list of active members and pending invites for a collection. Active members are ordered by display name, pending invites by email. Requires auth and read access. Limited to 100 results per page.


List Collection Members and Pending Invites


Removes an unclaimed invitation token using its internal identifier, not the publicly shared claim code.


Delete Invitation Token


Retrieves a collection and its associated assets using the collection identifier.


List Collection Assets


Modifies metadata and configuration attributes associated with an existing collection.


Update Collection Properties


Relocates a collection and its child collections to a new parent collection, returning list of all modified collections.


Move Collection and Descendants


Retrieves a collection and all associated discussion threads using the collection identifier.


List Collection Threads


Creates a new collection under the specified ancestor. Requires user authentication and proper authorization permissions.


Add New Collection


Irreversibly removes collections and all their contents including assets, threads, and child collections. Multiple collections can be deleted at once, but specified IDs must not include descendant collections.


Permanently Delete Collections


Fetches a specific collection using its unique identifier. Requires user authentication and proper access permissions.


View Collection Details


Associates multiple assets with a collection, allowing cross-organization relationships with proper access permissions.


Link Assets to Collection


Associates multiple threads with a collection, allowing cross-organization relationships with proper access permissions.


Link Threads to Collection


Generates a unique identifier for a new device registration.


Create New Device Identifier


Creates a secure, signed URL for administrators to access message diagnostic data.


Generate Admin Diagnostic URL


Stores diagnostic data from user feedback in blob storage and generates a secure access URL.


Upload User Feedback Diagnostics


Modifies user permissions for a shared collection. Updates can add new permissions, maintain existing ones, or remove a user's access entirely by providing no actions. Requires authentication and collection sharing authorization.


Update Collection Access Rights


Retrieves a list of assets that the user has recently interacted with or referenced.


Get User's Recent Assets


Retrieves the most recent conversation threads associated with the current user.


List User's Recent Threads


Enhances a prompt to help users write better prompts for thier use cases.


Enhance Prompt


Creates sharing permissions for a collection with specified users. Requires user authentication and collection sharing authorization.


Share Collection With Others


Starts a new conversation thread within the authenticated user's organization.


Create Organization Thread


Performs a soft delete operation on multiple threads, hiding them from queries but retaining data for potential recovery. Recovery window varies based on organization retention policy.


Delete Threads (Recoverable)


Retrieves a specific thread using its ID. Requires authentication and active focus on the thread's tenant organization.


Get Thread Details


Modifies metadata and configuration attributes associated with an existing thread.


Update Thread Properties


Handles and processes an incoming message within an existing conversation thread.


Process Thread Message


Creates a permanent public access token for thread sharing, which can be used to generate a shareable link or send via email.


Share Thread with Link or Email


Crawls a URL and creates an asset for the content suitable for chat.


Crawl URL


Combines two user accounts, transferring data from one account to another while preserving important user information.


Merge User Accounts


Creates a new user record or synchronizing an existing account with the authenticated identity from an auth service.


Auth Sync


Retrieves the complete hierarchical structure of a collection. Requires user authentication and proper access permissions.


API documentation

API Reference

Handle WebSocket Connection