Tough Tongue AI

Get unified analytics data in a single API call. Personal view (is_org_wide=false): - Returns scenario stats only Org view (is_org_wide=true): - Returns scenario stats (org-wide) - Returns org dashboard (time series, usage summary, wallet balance) - Returns member usage breakdown - Requires EDIT or OWNER role in the organization Query params: - is_org_wide: bool (default: false) - Toggle between personal and org-wide view - start_date: datetime (optional) - Filter analytics from this date (default: 90 days ago) - end_date: datetime (optional) - Filter analytics until this date (default: today)

get_analytics

Get detailed collection information with org context support. Access is granted if: - User is the creator of the collection - User has permissions to the collection (via Permission system) - Org has permissions to the collection (if in org context)

get_collection

Get a specific scenario details by ID with org context support. Access is granted if: - User is the creator of the scenario - User has permissions to the scenario (via Permission system) - Org has permissions to the scenario (if in org context)

get_scenario

Get detailed session information including transcript and evaluation data. The only public route returning a session transcript — /v2/sessions/batch omits it.

get_session

Fetch specific sessions by ID. Much faster than listing with filters.

get_sessions_batch

Get current wallet balance for the PAT user

get_balance

List all collections through the public API with org context support. Returns: - Collections created by the user (with org filtering) - Collections where the user has permissions (with org filtering) - Collections where the org has permissions (if in org context)

list_collections

List meeting bot records with pagination. Filters: - status: pending, scheduled, in_call_recording, call_ended, failed - scenario_id: Filter by specific scenario - from_date/to_date: ISO format (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ) - page/limit: Pagination (default: page=1, limit=50, max=500)

list_meeting_bots

List organizations the authenticated PAT user belongs to. Each item's `id` is the value the client should send back as the `X-TT-ORG` header to scope subsequent API calls into that organization. Omitting the header (or sending an empty value) keeps the call in personal context.

list_organizations

List SIP call records with pagination. Filters: - status: pending, scheduled, in_call_recording, call_ended, failed - scenario_id: Filter by specific scenario - batch_id: Filter by batch ID - from_date/to_date: ISO format (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ) - page/limit: Pagination (default: page=1, limit=50, max=500)

list_sip_calls

List configured SIP trunks for the caller (org-scoped when X-TT-ORG is set). Use this to discover a `sip_trunk_id` before dispatching outbound calls with `POST /sip/call` or `POST /sip/batch`. Outbound calls run on `outgoing` trunks; omit `sip_trunk_id` on dispatch to use the account default. Credentials (auth username/password, LiveKit IDs) are never returned.

list_sip_trunks

List all scenarios through the public API with org context support. Returns: - Scenarios created by the user (with org filtering) - Scenarios where the user has permissions (with org filtering) - Scenarios where the org has permissions (if in org context) - When is_featured=true: globally featured public scenarios (org ignored) Filters: - search: case-insensitive substring match on name + description - meta_<key>=value (exact match on user_metadata) - meta_$gt_<key>=value, meta_$gte_<key>=value, meta_$lt_<key>=value, meta_$lte_<key>=value

list_scenarios

List sessions with evaluation and improvement results. Response includes: - evaluation_results: Full evaluation (score, report_card, strengths, weaknesses) - improvement_results: Improvement areas, action items, resources Filters: - scenario_id, user_email, is_org, page, limit Date filters (convenience): - from_date / to_date: shorthand for updated_at range. Accepts YYYY-MM-DD or full ISO. to_date bumps to end-of-day automatically. Date filters (advanced — $op_<field> convention, same as metadata): - $gte_updated_at, $gt_updated_at, $lte_updated_at, $lt_updated_at - $gte_created_at, $gt_created_at, $lte_created_at, $lt_created_at - ISO format: YYYY-MM-DD or full ISO timestamp Both styles can be used together; advanced filters take precedence on overlap. Metadata filters: - meta_<key>=value (exact match on user_metadata) - meta_$gt_<key>=value, meta_$gte_<key>=value, meta_$lt_<key>=value, meta_$lte_<key>=value

list_sessions

List all product subscriptions for scenarios/collections created by the user. Args: user_email: Optional email filter to show subscriptions only from specific user

list_subscriptions

Run post-session processing (analysis and/or extraction) in the background. Which jobs run is governed by scenario config (`is_auto_analysis` / `enable_extraction`). Triggers even if a previous run failed — use this to retry after a failed analysis. No-ops if analysis was never configured on the scenario (returns 200 immediately). Response is always 200/OK — processing is async. Poll `GET /sessions/{id}` and check `post_session_status.state` (`running` → `idle` on success, `failed` on error) or the presence of `evaluation_results` / `extraction_results` to detect completion. If analysis is already in progress the bg task will skip silently (lock held).

post_process_session

Schedule meeting bot(s) via API token. Supports multiple URLs (newline-separated). The bot joins the meeting as a visible named participant and posts a chat message to everyone on joining, sent under its display name. Choose a bot_name that identifies it as an AI participant so attendees know they are talking to an agent — e.g. "Ava (AI Coach)", "Tough Tongue AI Notetaker". Requires: - Paid plan - User must own or have VIEW permission on the scenario - Org context: If X-TT-ORG header present, scenario must belong to that org

schedule_meeting_bot

Update an existing scenario. `id` is required; only provided fields change. Pass org_id when the scenario belongs to an organization. Use create_scenario for new scenarios.

update_scenario