Skip to main content
Every insightoai.api.* operation is listed below with parameter shapes and return types from the plugin Zod schemas.
New to Corsair? See API access, authentication, and error handling.

Agency

createAgency

agency.createAgency Create a new agency with organization-specific branding and config Risk: write
Input
Output: object

getAgencyBillingPlan

agency.getAgencyBillingPlan View an agency billing plan limits for bots, queries, words, and voice seconds Risk: read
Input Output: object

getAgencyBrandingById

agency.getAgencyBrandingById Retrieve the branding configuration for an agency Risk: read
Input Output: object

getAgentList

agency.getAgentList Fetch a paginated list of team agents/users Risk: read
Input Output: object

getPricingForUser

agency.getPricingForUser Retrieve pricing tier information for LLM, voice, or transcription services Risk: read
Input Output: object

retrieveUserMonthlyUsagesAggregation

agency.retrieveUserMonthlyUsagesAggregation Retrieve monthly aggregated usage analytics Risk: read
Input Output: object

updateUserProfile

agency.updateUserProfile Modify user account details, contact information, or billing settings Risk: write
Input Output: object

Assistants

addIntentToAssistant

assistants.addIntentToAssistant Link an existing conversational intent to an assistant Risk: write
Input
Output: object

createIntent

assistants.createIntent Create a new custom conversational intent Risk: write
Input
Output: object

createPrompt

assistants.createPrompt Create a new customizable AI prompt template with variable support Risk: write
Input Output: object

deleteAssistantById

assistants.deleteAssistantById Permanently remove an assistant from the system Risk: destructive · Irreversible
Input Output: object

deletePromptById

assistants.deletePromptById Permanently delete a prompt template by ID Risk: destructive · Irreversible
Input Output: object

getAssistantById

assistants.getAssistantById Retrieve comprehensive details and configuration of a specific assistant Risk: read
Input Output: object

getIntentById

assistants.getIntentById Retrieve details of a specific intent by ID Risk: read
Input Output: object

getPromptById

assistants.getPromptById Retrieve details of a specific prompt template by ID Risk: read
Input Output: object

readIntentsList

assistants.readIntentsList Retrieve a paginated list of all configured intents Risk: read
Input Output: object

Contacts

createContactCustomField

contacts.createContactCustomField Create a custom metadata field for contacts Risk: write
Input Output: object

deleteContactsInBulk

contacts.deleteContactsInBulk Delete multiple contacts simultaneously by UUIDs Risk: destructive · Irreversible
Input Output: object

getContactById

contacts.getContactById Retrieve a comprehensive profile of a specific contact Risk: read
Input Output: object

getListOfContacts

contacts.getListOfContacts Fetch a paginated list of contacts Risk: read
Input Output: object

readCampaignContactList

contacts.readCampaignContactList Fetch all contacts enrolled in a specific campaign Risk: read
Input Output: object

readContactCustomFieldList

contacts.readContactCustomFieldList Retrieve definitions of all contact custom fields Risk: read
Input Output: object

readContactSyncLogList

contacts.readContactSyncLogList Retrieve audit history and logs of contact synchronization operations Risk: read
Input Output: object

sendMessagesToContacts

contacts.sendMessagesToContacts Send bulk broadcast messages to contacts via connected WhatsApp or SMS Risk: write
Input Output: object

upsertContactByEmailOrPhoneNumber

contacts.upsertContactByEmailOrPhoneNumber Create or update a contact using email or phone number Risk: write
Input Output: object

Datasources

createTag

datasources.createTag Create a custom tag for categorizing contacts and conversations Risk: write
Input
Output: object

deleteLinkedAssistantDatasource

datasources.deleteLinkedAssistantDatasource Unlink and remove a data source from an assistant’s knowledge base Risk: destructive · Irreversible
Input Output: object

deleteLinkTagEntityById

datasources.deleteLinkTagEntityById Remove a specific tag association from an entity Risk: destructive · Irreversible
Input Output: object

deleteTagById

datasources.deleteTagById Permanently remove a tag by ID Risk: destructive · Irreversible
Input Output: object

getDatasourceById

datasources.getDatasourceById Retrieve comprehensive details of a specific knowledge base data source Risk: read
Input Output: object

getListOfDatasources

datasources.getListOfDatasources Discover all available knowledge base data sources (text, URLs, files) Risk: read
Input Output: object

getListOfDataSourcesLinkedToAssistantId

datasources.getListOfDataSourcesLinkedToAssistantId List all data sources linked to an assistant Risk: read
Input Output: object

readTagList

datasources.readTagList Fetch a paginated list of all available tags Risk: read
Input Output: object

Forms

createForm

forms.createForm Create a conversational AI-driven or traditional data capture form Risk: write
Input
Output: object

deleteBulkFormsByIds

forms.deleteBulkFormsByIds Delete multiple forms in a single bulk operation Risk: destructive · Irreversible
Input Output: object

deleteFormById

forms.deleteFormById Permanently remove a form by unique ID Risk: destructive · Irreversible
Input Output: object

getCapturedFormByFormId

forms.getCapturedFormByFormId Fetch captured user form submissions with pagination Risk: read
Input Output: object

Providers

createProvider

providers.createProvider Configure an AI provider (OpenAI, ElevenLabs, Azure Speech, Cartesia, PlayHT) Risk: write
Input
Output: object

deleteProviderById

providers.deleteProviderById Permanently delete an AI provider configuration Risk: destructive · Irreversible
Input Output: object

getProviderById

providers.getProviderById Retrieve configuration details of an AI provider Risk: read
Input Output: object

getSpeechtotextList

providers.getSpeechtotextList Fetch a paginated list of available speech-to-text voice configurations Risk: read
Input Output: object

retrieveListOfUserCustomVoice

providers.retrieveListOfUserCustomVoice Retrieve a paginated list of custom user voice models Risk: read
Input Output: object

Tools

createToolfunction

tools.createToolfunction Register a new tool function (SDK, CURL, or query index) for assistant workflows Risk: write
Input
Output: object

deleteToolById

tools.deleteToolById Remove an entire tool integration by ID Risk: destructive · Irreversible
Input Output: object

deleteToolfunctionById

tools.deleteToolfunctionById Remove a tool function from the system Risk: destructive · Irreversible
Input Output: object

readToolFunctionInvokeLogList

tools.readToolFunctionInvokeLogList Inspect execution history and audit logs of tool function calls Risk: read
Input Output: object

readToolToolfunctionList

tools.readToolToolfunctionList Fetch all tool functions associated with a specific tool ID Risk: read
Input Output: object

retrieveLinkedToolAndUser

tools.retrieveLinkedToolAndUser Retrieve linked tool and user associations Risk: read
Input Output: object

updateLinkToolUser

tools.updateLinkToolUser Modify properties of a linked tool user integration Risk: write
Input
Output: object

updateToolById

tools.updateToolById Modify general properties and enabled status of a tool Risk: write
Input
Output: object

updateToolfunctionById

tools.updateToolfunctionById Modify the name, type, or enabled status of an existing tool function Risk: write
Input
Output: object

Webhooks Telephony

createWebhook

webhooksTelephony.createWebhook Configure an outbound webhook URL for event notifications Risk: write
Input Output: object

deleteTwilioAuthById

webhooksTelephony.deleteTwilioAuthById Remove a Twilio authentication integration Risk: destructive · Irreversible
Input Output: object

deleteUserwhatsappById

webhooksTelephony.deleteUserwhatsappById Remove a WhatsApp Business connection Risk: destructive · Irreversible
Input Output: object

deleteWebhookById

webhooksTelephony.deleteWebhookById Permanently remove an outbound webhook configuration Risk: destructive · Irreversible
Input Output: object

readTwilioAuthList

webhooksTelephony.readTwilioAuthList Retrieve all configured Twilio authentication integrations Risk: read
Input Output: object

retrieveWebhookLog

webhooksTelephony.retrieveWebhookLog Inspect delivery status and debug logs for a specific webhook Risk: read
Input Output: object

updateTwilioAuthById

webhooksTelephony.updateTwilioAuthById Modify Twilio auth credentials or telephony settings Risk: write
Input Output: object

updateUserwhatsappById

webhooksTelephony.updateUserwhatsappById Modify WhatsApp Business API settings for a user Risk: write
Input Output: object

updateWebhookById

webhooksTelephony.updateWebhookById Modify the endpoint URL, name, or enabled status of an outbound webhook Risk: write
Input Output: object

Widgets

createWidget

widgets.createWidget Create a new chat/voice widget for web or mobile embedding Risk: write
Input
Output: object

deleteWidgetById

widgets.deleteWidgetById Permanently remove a widget by ID Risk: destructive · Irreversible
Input Output: object

getListOfConversations

widgets.getListOfConversations Retrieve filtered conversation metadata across date ranges Risk: read
Input Output: object

getListOfWidgetsLinkedToAssistantId

widgets.getListOfWidgetsLinkedToAssistantId Discover all widgets associated with a specific assistant Risk: read
Input Output: object

getWidgetById

widgets.getWidgetById Retrieve widget configuration and visual styling attributes Risk: read
Input Output: object

listChannels

widgets.listChannels Retrieve all available communication channels and configurations Risk: read
Input Output: object