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.
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
# 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.
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.