> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Mihu AI

> Mihu AI provides workspace APIs for building and operating AI agents across voice, messaging, customer engagement, automation, and analytics.

![Mihu AI logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/mihu_ai.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=4b4847a3e5a7bccf546d97416ac40439)

* **Category:** ai agents
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `MIHU_AI`
* **Version:** 00000000\_00

## Tools

> [accordion] Get Call Analytics
>
> **Slug:** `MIHU_AI_GET_CALL_ANALYTICS`
>
> Return authoritative aggregate call counts, duration, outcomes, handling, and cost for a required half-open time window.
>
> #### Input Parameters
>
> **channel** `string`
>
> Comma-separated call channel tokens, such as call,whatsapp\_call.
>
> **end\_time** `string` *required*
>
> Exclusive ISO-8601 end timestamp with a UTC offset.
>
> **agent\_uuid** `string`
>
> Restrict metrics to this agent UUID.
>
> **start\_time** `string` *required*
>
> Inclusive ISO-8601 start timestamp with a UTC offset.
>
> **granularity** `string`
>
> Aggregation granularity; Mihu AI currently supports only total.
>
> **compare\_prev** `boolean`
>
> Include metrics for the immediately preceding window of equal length.
>
> **campaign\_uuid** `string`
>
> Restrict metrics to this campaign UUID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Task
>
> **Slug:** `MIHU_AI_GET_TASK`
>
> Retrieve one existing asynchronous task when its UUID is already known from another Mihu AI response.
>
> #### Input Parameters
>
> **uuid** `string` *required*
>
> UUID of the task to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workspace
>
> **Slug:** `MIHU_AI_GET_WORKSPACE`
>
> Return the connected Mihu AI workspace identity, locale, timezone, and wallet balance.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Agents
>
> **Slug:** `MIHU_AI_LIST_AGENTS`
>
> List workspace agents, optionally filtered by lifecycle status or searched by text.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum agents to return in this page (1-100).
>
> **cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> **search** `string`
>
> Search agents using provider text matching.
>
> **status** `string ("pending" | "ready" | "in_progress" | "paused" | "completed")`
>
> Return only agents in this lifecycle status.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Appointments
>
> **Slug:** `MIHU_AI_LIST_APPOINTMENTS`
>
> List appointments filtered by schedule, contact, status, or date range.
>
> #### Input Parameters
>
> **status** `string ("approved" | "pending" | "rejected" | "cancelled")`
>
> Return appointments with this status.
>
> **end\_date** `string`
>
> Include appointments on or before this YYYY-MM-DD date.
>
> **start\_date** `string`
>
> Include appointments on or after this YYYY-MM-DD date.
>
> **contact\_uuid** `string`
>
> Return appointments for this contact UUID.
>
> **schedule\_uuid** `string`
>
> Return appointments for this schedule UUID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Calls
>
> **Slug:** `MIHU_AI_LIST_CALLS`
>
> List calls filtered by agent, call status, or inbound/outbound/web direction.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum calls to return in this page (1-100).
>
> **cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> **status** `string ("in-progress" | "ended" | "missed" | "failed")`
>
> Return calls with this status.
>
> **direction** `string ("Inbound" | "Outbound" | "webCall")`
>
> Return calls with this direction.
>
> **agent\_uuid** `string`
>
> Return calls handled by this agent UUID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Campaigns
>
> **Slug:** `MIHU_AI_LIST_CAMPAIGNS`
>
> List one page of campaigns, optionally searched by name or description and filtered by lifecycle status.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum campaigns to return in this page (1-100).
>
> **cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> **search** `string`
>
> Search campaign name or description.
>
> **status** `string ("Active" | "Draft" | "Completed" | "Archived")`
>
> Return campaigns with this lifecycle status.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Contacts
>
> **Slug:** `MIHU_AI_LIST_CONTACTS`
>
> Search and filter workspace contacts by identity, status, channel, pipeline, campaign, tag, pool, or creation date.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum contacts to return in this page (1-100).
>
> **cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> **search** `string`
>
> Search contact name, email, or phone number.
>
> **status** `string ("Active" | "Inactive")`
>
> Return contacts with this status.
>
> **date\_to** `string`
>
> Include contacts created on or before this YYYY-MM-DD date.
>
> **tag\_uuid** `string`
>
> Return contacts carrying this tag UUID.
>
> **date\_from** `string`
>
> Include contacts created on or after this YYYY-MM-DD date.
>
> **pool\_uuid** `string`
>
> Return contacts in this pool UUID.
>
> **stage\_uuid** `string`
>
> Return contacts currently in this pipeline stage UUID.
>
> **campaign\_uuid** `string`
>
> Return contacts whose pool is attached to this campaign UUID.
>
> **contact\_channel** `string ("Call" | "SMS" | "WhatsApp")`
>
> Return contacts whose preferred contact channel matches this value.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Conversations
>
> **Slug:** `MIHU_AI_LIST_CONVERSATIONS`
>
> Find conversations by contact, exact or partial phone, agent, campaign, task, channel, status, or label. Returns one page and a continuation cursor.
>
> #### Input Parameters
>
> **label** `string`
>
> Return conversations with this label UUID; the label named Open also includes unlabeled conversations.
>
> **limit** `integer`
>
> Maximum conversations to return in this page (1-100).
>
> **phone** `string`
>
> Partially match a contact phone number.
>
> **cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> **status** `string ("Active" | "Closed")`
>
> Return conversations with this status.
>
> **channel** `string`
>
> Return conversations on this provider channel name, such as whatsapp, sms, or call.
>
> **sort\_by** `string ("timestamp" | "created_at" | "updated_at")`
>
> Field used to sort results; timestamp means last activity.
>
> **sort\_dir** `string ("asc" | "desc")`
>
> Sort direction.
>
> **task\_uuid** `string`
>
> Return conversations linked through a call to this task UUID.
>
> **agent\_uuid** `string`
>
> Return conversations handled by this agent UUID.
>
> **contact\_uuid** `string`
>
> Return conversations for this contact UUID.
>
> **phone\_number** `string`
>
> Exactly match a contact number digit-by-digit; formatting and a leading plus sign are ignored.
>
> **campaign\_uuid** `string`
>
> Return conversations linked through a call to this campaign UUID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Sessions
>
> **Slug:** `MIHU_AI_LIST_SESSIONS`
>
> List one page of conversation sessions filtered by conversation, contact, agent, campaign, task, status, or text/voice type.
>
> #### Input Parameters
>
> **type** `string ("text" | "voice")`
>
> Return text or voice sessions.
>
> **limit** `integer`
>
> Maximum sessions to return in this page (1-100).
>
> **cursor** `string`
>
> Continuation cursor returned by a previous call; omit for the first page.
>
> **status** `string ("active" | "completed" | "timed_out")`
>
> Return sessions with this status.
>
> **sort\_by** `string ("created_at" | "updated_at" | "started_at" | "last_activity_at")`
>
> Field used to sort sessions.
>
> **sort\_dir** `string ("asc" | "desc")`
>
> Sort direction.
>
> **task\_uuid** `string`
>
> Return sessions linked through a call to this task UUID.
>
> **agent\_uuid** `string`
>
> Return sessions handled by this agent UUID.
>
> **contact\_uuid** `string`
>
> Return sessions for this contact UUID.
>
> **campaign\_uuid** `string`
>
> Return sessions linked through a call to this campaign UUID.
>
> **conversation\_uuid** `string`
>
> Return sessions in this conversation UUID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
