Ringover · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Ringover Public Empower API

15 actions 15 updates phrasing extends openapi/ringover-empower-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Ringover's API. It is a proposal applied on top of the contract, not a document Ringover publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 15

$.info
$.paths['/empower/calls'].get
$.paths['/empower/calls'].delete
$.paths['/empower/logs/calls'].post
$.paths['/empower/platform/{platformName}/channel/{channelID}'].get
$.paths['/empower/chat'].post
$.paths['/empower/call/{callUUID}'].get
$.paths['/empower/call/{callUUID}/moments'].get
$.paths['/empower/call/{callUUID}/summary'].get
$.paths['/empower/call'].post
$.paths['/empower/analytics'].post
$.paths['/empower/upload/call'].post
$.paths['/empower/flags'].get
$.paths['/empower/flag/{flag_id}/call/{call_uuid}'].post
$.paths['/empower/flag/{flag_id}/call/{call_uuid}'].delete

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Ringover Public Empower API
  version: 1.0.0
extends: openapi/ringover-empower-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-11-20'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 14
- target: $.paths['/empower/calls'].get
  update:
    x-apievangelist-phrasing:
      intent: List calls analyzed by Empower
      effect: read
      questions:
      - Which calls has Empower analyzed for a given date range?
      - Can I filter Empower-analyzed calls by mood or language?
      - What is the maximum date range I can search Empower calls?
      instructions:
      - text: List Empower-analyzed calls from {call_date_from} to {call_date_to}.
        slots:
          call_date_from: query.call_date_from
          call_date_to: query.call_date_to
      - text: Show calls with mood {mood_label} in language {language}.
        slots:
          mood_label: query.mood_label
          language: query.language
      - text: Find calls from {call_source} with audio duration between {audio_duration_from} and {audio_duration_to} seconds.
        slots:
          call_source: query.call_source
          audio_duration_from: query.audio_duration_from
          audio_duration_to: query.audio_duration_to
      method: generated
      generated: '2026-11-20'
- target: $.paths['/empower/calls'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete Empower-analyzed calls or their media
      effect: destructive
      questions:
      - Can I remove only the audio from Empower-analyzed calls and keep the call records?
      - How do I delete several Empower calls at once?
      instructions:
      - text: Delete media only from Empower calls {call_uuids}.
        slots:
          call_uuids: requestBody.call_uuids
      - text: Delete Empower calls {call_uuids} entirely.
        slots:
          call_uuids: requestBody.call_uuids
      method: generated
      generated: '2026-11-20'
- target: $.paths['/empower/logs/calls'].post
  update:
    x-apievangelist-phrasing:
      intent: Get Empower call logs
      effect: read
      questions:
      - Can I get the call detail records (CDR) for a date range?
      - Which calls were flagged with a specific transcription state?
      instructions:
      - text: Get Empower call logs from {start_date} to {end_date}.
        slots:
          start_date: requestBody.start_date
          end_date: requestBody.end_date
      - text: List Empower call logs with transcription state {transcription_state}.
        slots:
          transcription_state: requestBody.transcription_state
      method: generated
      generated: '2026-11-20'
- target: $.paths['/empower/platform/{platformName}/channel/{channelID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Empower call UUID from a platform channel
      effect: read
      questions:
      - How do I find the Empower call UUID for a call on a specific platform channel?
      - Can I cross-reference a Ringover call with a call on another platform?
      instructions:
      - text: Get the Empower call UUID for channel {channelID} on {platformName}.
        slots:
          channelID: path.channelID
          platformName: path.platformName
      - text: Look up the call on {platformName} channel {channelID} in Empower.
        slots:
          platformName: path.platformName
          channelID: path.channelID
      method: generated
      generated: '2026-11-20'
- target: $.paths['/empower/chat'].post
  update:
    x-apievangelist-phrasing:
      intent: Ask Empower AI a question about a call
      effect: read
      questions:
      - Can I ask Empower AI to summarize a call's conversation history?
      - How do I send a chat message to Empower AI for a specific call?
      instructions:
      - text: 'Ask Empower AI on call {call_id}: {message}.'
        slots:
          call_id: requestBody.call_id
          message: requestBody.message
      - text: Chat with Empower AI about call {call_id} using transcription {transcription}.
        slots:
          call_id: requestBody.call_id
          transcription: requestBody.transcription
      method: generated
      generated: '2026-11-20'
- target: $.paths['/empower/call/{callUUID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get full details of an Empower-analyzed call
      effect: read
      questions:
      - What scores and metadata does Empower give a specific call?
      - Can I see the full transcription of one Empower-analyzed call?
      instructions:
      - text: Get full details of Empower call {callUUID}.
        slots:
          callUUID: path.callUUID
      - text: Show scores and metadata for Empower-analyzed call {callUUID}.
        slots:
          callUUID: path.callUUID
      method: generated
      generated: '2026-11-20'
- target: $.paths['/empower/call/{callUUID}/moments'].get
  update:
    x-apievangelist-phrasing:
      intent: Get key moments detected in a call
      effect: read
      questions:
      - Which objections, commitments or questions did Empower detect in a call?
      - What key moments were flagged in a specific Empower-analyzed call?
      instructions:
      - text: Get key moments detected in call {callUUID}.
        slots:
          callUUID: path.callUUID
      - text: List the objections and commitments found in Empower call {callUUID}.
        slots:
          callUUID: path.callUUID
      method: generated
      generated: '2026-11-20'
- target: $.paths['/empower/call/{callUUID}/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the AI-generated summary of a call
      effect: read
      questions:
      - What does Empower's AI summary say about a call?
      - Can I get a recap of a call's key topics and action items?
      instructions:
      - text: Get the AI summary of call {callUUID}.
        slots:
          callUUID: path.callUUID
      - text: Show the recap for Empower-analyzed call {callUUID}.
        slots:
          callUUID: path.callUUID
      method: generated
      generated: '2026-11-20'
- target: $.paths['/empower/call'].post
  update:
    x-apievangelist-phrasing:
      intent: Get call summaries for a user in a date range
      effect: read
      questions:
      - Can I get Empower call summaries for one user over a date range?
      - How do I get recap, moments and scores for a user's calls?
      instructions:
      - text: Get call summaries for user {user_id} from {start_date} to {end_date}.
        slots:
          user_id: requestBody.user_id
          start_date: requestBody.start_date
          end_date: requestBody.end_date
      - text: Summarize {limit} calls for user {user_id} in {start_date} to {end_date}.
        slots:
          limit: requestBody.limit
          user_id: requestBody.user_id
          start_date: requestBody.start_date
          end_date: requestBody.end_date
      method: generated
      generated: '2026-11-20'
- target: $.paths['/empower/analytics'].post
  update:
    x-apievangelist-phrasing:
      intent: Download Empower analytics and statistics
      effect: read
      questions:
      - Can I download Empower analytics as a CSV file?
      - Which Empower stats types can I request?
      instructions:
      - text: Download Empower analytics as {output}.
        slots:
          output: requestBody.output
      - text: Get Empower {type} stats for user {user_id} in {time_frame}.
        slots:
          type: requestBody.type
          user_id: requestBody.user_id
          time_frame: requestBody.time_frame
      method: generated
      generated: '2026-11-20'
- target: $.paths['/empower/upload/call'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload an external call or video for Empower analysis
      effect: write
      questions:
      - How do I upload an external call recording for Empower AI analysis?
      - Can I upload a video call and have Empower analyze it?
      instructions:
      - text: Upload an external call {file} for analysis with direction {call_direction}.
        slots:
          file: requestBody.file
          call_direction: requestBody.call_direction
      - text: Upload video call {file} with {speaker_count} speakers for Empower analysis.
        slots:
          file: requestBody.file
          speaker_count: requestBody.speaker_count
      method: generated
      generated: '2026-11-20'
- target: $.paths['/empower/flags'].get
  update:
    x-apievangelist-phrasing:
      intent: List flags configured for the team
      effect: read
      questions:
      - What flags are available to tag calls with?
      - Which call flags have been set up for my team?
      instructions:
      - text: List all team flags.
      - text: Show the flags I can use to tag calls.
      method: generated
      generated: '2026-11-20'
- target: $.paths['/empower/flag/{flag_id}/call/{call_uuid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Tag a call with a flag
      effect: write
      questions:
      - Can I tag a call with a flag so I can review it later?
      - How do I associate a flag with a specific call?
      instructions:
      - text: Tag call {call_uuid} with flag {flag_id}.
        slots:
          call_uuid: path.call_uuid
          flag_id: path.flag_id
      - text: Add flag {flag_id} to call {call_uuid}.
        slots:
          flag_id: path.flag_id
          call_uuid: path.call_uuid
      method: generated
      generated: '2026-11-20'
- target: $.paths['/empower/flag/{flag_id}/call/{call_uuid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a flag from a call
      effect: destructive
      questions:
      - Can I untag a call by removing its flag?
      - How do I take a flag off a call I already tagged?
      instructions:
      - text: Remove flag {flag_id} from call {call_uuid}.
        slots:
          flag_id: path.flag_id
          call_uuid: path.call_uuid
      - text: Untag call {call_uuid} by deleting flag {flag_id}.
        slots:
          call_uuid: path.call_uuid
          flag_id: path.flag_id
      method: generated
      generated: '2026-11-20'

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/ringover-empower-api-phrasing-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.