Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Kin Lane

Chat with Kin

AI assistant · trained on my blog

Webex

Webex Features: Announcement Repository API

The Features: Announcement Repository API from Webex — 10 operation(s) for features: announcement repository.

Documentation Provider Profile APIs.io OpenAPI GitHub

Webex Features: Announcement Repository API is one of 178 APIs that Webex publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Features: Announcement Repository. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 15 operations across 10 paths, and defines 15 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

15 operations 10 paths 15 schemas 2 DELETE8 GET3 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Authentication
OAuth 2.0, HTTP Bearer, OAuth 2.0
Resource Areas
1

Authentication & Security 3

Webex Features: Announcement Repository API declares 3 security schemes for authenticating requests. It supports OAuth 2.0 (oauth2) using the authorizationCode flow. It accepts HTTP bearer tokens (JWT) (bearer-key). It supports OAuth 2.0 (bearerAuth) using the authorizationCode flow, exposing 1 scope.

  • bearer-key — e.g. Bearer YOURAUTHORIZATIONTOKEN
  • bearerAuth — OAuth 2.0 Bearer token authentication

Paths & Operations 15

Across 10 paths, the API surfaces 15 operations — 2 DELETE, 8 GET, 3 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Features: Announcement Repository 15
GET
/telephony/config/announcements
Fetch list of announcement greetings on location and organization level
Fetch list of announcement greetings on location and organization level 9 params → 200400401403404405409410
POST
/telephony/config/announcements
Upload a binary announcement greeting at organization level
Upload a binary announcement greeting at organization level 1 param body → 201400401403404405409410
GET
/telephony/config/announcements/usage
Fetch repository usage for announcements for an organization
Fetch repository usage for announcements for an organization 1 param → 200400401403404405409410
DELETE
/telephony/config/announcements/{announcementId}
Delete an announcement greeting of the organization
Delete an announcement greeting of the organization 2 params → 204400401403404405409410
GET
/telephony/config/announcements/{announcementId}
Fetch details of a binary announcement greeting at the organization level
Fetch details of a binary announcement greeting at the organization level 2 params → 200400401403404405409410
PUT
/telephony/config/announcements/{announcementId}
Modify a binary announcement greeting at organization level
Modify a binary announcement greeting at organization level 2 params body → 204400401403404405409410
POST
/telephony/config/locations/{locationId}/announcements
Upload a binary announcement greeting at the location level
Upload a binary announcement greeting at the location level 2 params body → 201400401403404405409410
GET
/telephony/config/locations/{locationId}/announcements/usage
Fetch repository usage for announcements in a location
Fetch repository usage for announcements in a location 2 params → 200400401403404405409410
DELETE
/telephony/config/locations/{locationId}/announcements/{announcementId}
Delete an announcement greeting in a location
Delete an announcement greeting in a location 3 params → 204400401403404405409410
GET
/telephony/config/locations/{locationId}/announcements/{announcementId}
Fetch details of a binary announcement greeting at location level
Fetch details of a binary announcement greeting at location level 3 params → 200400401403404405409410
PUT
/telephony/config/locations/{locationId}/announcements/{announcementId}
Modify a binary announcement greeting at location level
Modify a binary announcement greeting at location level 3 params body → 204400401403404405409410
POST
/telephony/config/textToSpeech/actions/generate/invoke
Generate a Text-to-Speech Prompt
generateTextToSpeech 1 param body → 202400401403404405415429
GET
/telephony/config/textToSpeech/usage
Get Text-to-Speech Usage
getTextToSpeechUsage 1 param → 200400401403404405429500
GET
/telephony/config/textToSpeech/{ttsId}
Get Text-to-Speech Generation Status
getTextToSpeechGenerationStatus 2 params → 200400401403404405410429
GET
/telephony/config/textToSpeech/voices
List Text-to-Speech Voices
listTextToSpeechVoices 1 param → 200400401403404405429500

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are AnnouncementResponseWithPlaylist (13 properties), AnnouncementResponse (12 properties), TtsStatusResponse (9 properties), AnnouncementsListResponse (9 properties). Each schema is shown below with its type and property counts.

AnnouncementResponseWithId
object
Response containing the unique identifier of a created or updated announcement.
1 property 1 required
TtsUsageResponse
object
Response containing text-to-speech usage information.
3 properties 2 required
PlaylistObject
object
Basic playlist metadata available for announcement selection.
2 properties 2 required
FeatureReferenceObject
object
Metadata describing a call feature that references an announcement.
5 properties 5 required
TtsStatusResponse
object
Response containing text-to-speech generation status and file references.
9 properties 5 required
AnnouncementRequestBody
object
Request payload for uploading or updating an announcement in the repository.
4 properties 4 required
AnnouncementUsageResponse
object
Response containing announcement repository storage usage limits and current utilization.
4 properties 4 required
GenerateTtsResponse
object
Response containing the ID of the text-to-speech generation request.
1 property 1 required
AnnouncementResponse
object
Response containing announcement details.
12 properties 6 required
TtsVoicesResponse
object
Response containing the list of supported text-to-speech voices.
1 property 1 required
AnnouncementResponseWithPlaylist
object
Response containing announcement details and available playlists.
13 properties 6 required
LocationObject
object
2 properties 2 required
AnnouncementsListResponse
object
Response containing announcement summary details for list operations.
9 properties 7 required
GenerateTtsRequest
object
Request payload for generating a text-to-speech audio prompt.
3 properties 3 required
TtsVoice
object
Text-to-Speech voice metadata.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

webex-features-announcement-repository-api-openapi.yml Raw ↑

Other APIs Webex publishes across the network.

Webex Address Book API
AE Profile APIs.io
Webex Admin Audit Events API
AE Profile APIs.io
Webex Agent Personal Greeting Files API
AE Profile APIs.io
Webex Agent Summaries API
AE Profile APIs.io
Webex Agent Wellbeing API
AE Profile APIs.io
Webex Agents API
AE Profile APIs.io
Webex AI Feature API
AE Profile APIs.io
Webex API - Domain Management API
AE Profile APIs.io
Webex Archive Users API
AE Profile APIs.io
Webex Attachment Actions API
AE Profile APIs.io
Webex Audio Files API
AE Profile APIs.io
Webex Authorizations API
AE Profile APIs.io
#Features: Announcement Repository
← Back to W APIs
API Details
ID
webex:webex-features-announcement-repository-api
Docs
https://developer.webex.com/docs/messaging
Provider
Webex
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network