Built by Metorial, the integration platform for agentic AI.
Retrieve all teams accessible with the current API key. Returns team details including name, status, plan info, and usage statistics (bot count, source count, question count).
Rate a bot's answer as positive, negative, or neutral (reset). Use the answerId from a chat response to submit the rating. Call list_teams to discover accessible team IDs.
Add a new training source to a bot. Supports URL, sitemap, YouTube, RSS, Q&A pairs, and file-based sources. For file uploads, first use the **Get Upload URL** tool to obtain a presigned URL, upload the file, then pass the returned file path here. Call list_teams to discover accessible team IDs.
Soft-delete a question from the bot's question history. The question is flagged as deleted and its content is cleared. Call list_teams to discover accessible team IDs.
Retrieve full details of a conversation session including the complete message history, summary, sentiment, resolution/escalation status, and user metadata. Call list_teams to discover accessible team IDs.
Permanently delete a bot and all its associated sources and data. This action cannot be undone. Call list_teams to discover accessible team IDs.
List a page of training sources for a bot. Call list_teams to discover team IDs. Returns source status and indexing counts, with pagination for retrieving the next page.
Update an existing bot's settings including name, description, AI model, custom prompt instructions, privacy, widget appearance (color, icon, alignment), allowed domains, branding, support link, and UI labels. Only provided fields are updated. Call list_teams to discover accessible team IDs.
Delete a conversation session and all its messages from a bot. Requires bot edit permissions. Call list_teams to discover accessible team IDs.
Delete a training source from a bot. The source data will be removed from the bot's index. Sources may still appear in chat results for several minutes while being fully removed. Call list_teams to discover accessible team IDs.
Retrieve question and answer history for a bot. Supports filtering by rating, escalation status, answer capability, date range, and IP hash. Returns paginated results with question text, answer, sources, and metadata. Call list_teams to discover accessible team IDs.
Retrieve full details for a specific bot including its configuration, model, status, widget settings, labels, and usage statistics. Call list_teams to discover accessible team IDs.
Mark an individual answer in question history as escalated to human support. This records question-level escalation and does not confirm escalation of a whole conversation. Call list_teams to discover accessible team IDs.
Create a new AI chatbot for a team selected with list_teams. Requires a name, description, privacy level, and language. Optionally specify the AI model or duplicate an existing bot.
Get a presigned upload URL for uploading a file to use as a bot training source. After uploading the file to the returned URL, use the returned file path with the **Create Source** tool. Call list_teams to discover accessible team IDs.
Retrieve paginated conversation sessions for a bot. Returns conversation summaries including title, sentiment, resolution status, escalation status, and timestamps. Use **Get Conversation** to retrieve full message history. Call list_teams to discover accessible team IDs.
List all bots for a team selected with list_teams. Returns each bot's name, description, model, status, and usage statistics.
Send a question to a DocsBot AI agent and receive an answer with source citations. Supports multi-turn conversations by reusing the same conversationId, multimodal inputs via image URLs, and configurable parameters like reasoning effort and context items. Call list_teams to discover accessible team IDs.
Retrieve a team’s current usage and plan limits. Call list_teams to discover accessible team IDs.
Retry a failed training source or update its dashboard title without reindexing. Call list_teams and list_sources to discover IDs. Title updates support URL lists, sitemaps, website sources, and multi-file documents; other source types return a provider conflict.
Inspect a training source, including ingest progress, warnings, indexed URLs, FAQ pairs, and multi-file filenames. Call list_teams to discover team IDs and list_sources to discover source IDs.