Product
Jentic OSThe workplace. An in-house AI platform for every employeeJentic OneSafe access. Agents reach your systems without holding keysJentic AIRThe foundation. Gets your existing platforms ready for AI
Pricing
Developers

GET STARTED

API DirectoryBrowse 10,000+ APIs Ready For AI Agent IntegrationDocumentationGuides and API reference

TOOLS

API ScoringCheck your AI Readiness using our scorecardArazzo UIVisualize Arazzo Workflows As Interactive DocumentationArazzo EditorBuild And Edit Multi-Step API Workflows Visually

COMMUNITY

GitHubOpen source projects and examplesOpen StandardsBuilt on open specs. Never locked in.
Resources
Company
About UsOur mission and teamCareersJoin our teamContactGet in touch
Try it now
Jentic OSJentic OneJentic AIR
Pricing
API DirectoryDocumentationAPI ScoringArazzo UIArazzo EditorGitHubOpen Standards
Resources
About UsCareersContact
Try it now
JenticJentic
Products
  • Jentic OS
  • Jentic One
  • Jentic AIR
For Developers
  • API Directory
  • Documentation
  • GitHub
Company
  • About Jentic
  • Careers
  • Contact Us
  • Trust Centre
ISO/IEC 27001:2022 certification badge issued by Prescient SecurityISO/IEC 27001:2022 certification badge issued by Prescient Security

Information Security Management System

Certified to ISO/IEC 27001:2022 by Prescient Security

AICPA SOC for Service Organizations logoAICPA SOC for Service Organizations logo

SOC 2® Type 1 report

Audited by Prescient Assurance

Terms & Conditions•Privacy Policy•
© 2026 Jentic Technology Ltd. All rights reserved.
2 Grattan Court East, Dublin, D02 VX86, Ireland
Switch to light modeSwitch to dark mode
APIs / Media / Nexmo / Nexmo Media API
Nexmo Media API logo

Nexmo Media API

Browse all Nexmo APIs
78
AI ReadinessAI-Ready (A-)78/100
See full scorecard
Agent-ready OpenAPI document · curated by JenticMediaAudio Processingnone4 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Manage audio media items used by Nexmo Voice - list, retrieve metadata, update metadata, and delete by id. Four endpoints.

Use for: List Nexmo media items belonging to this account, Get the metadata for a media item by id, Search media items created on a particular date, Update the title of an audio prompt

Not supported: Does not upload new media, transcribe audio, or play files into a call - use only to list, inspect, update metadata for, and delete items already stored in the Nexmo media bucket.

Jentic publishes the only available OpenAPI specification for Nexmo Media API, keeping it validated and agent-ready. This media-api slug is the alternate-named copy of the Media service. The same four endpoints under /v3/media cover listing and searching media items, retrieving and updating per-item metadata, and deleting items. Voice applications reference these stored audio files for prompts and recordings.

Jentic One on GithubView OpenAPI Document

Install Jentic One Beta

Connect the Nexmo Media API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Nexmo Media API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

1

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fnexmo.com%2Fnexmo-media-api" | sh
2

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fnexmo.com%2Fnexmo-media-api" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Nexmo Media API.

List and search media items via GET /

Retrieve metadata for a specific media item via GET /:id/info

Update metadata fields on a media item via PUT /:id/info

Delete a media item by id via DELETE /:id

Reference media items by id from a Nexmo Voice NCCO talk or stream action

Use Cases

Patterns agents use Nexmo Media API for, with concrete tasks.

★ Voice prompt management for IVR flows

IVR developers store welcome messages, menu prompts, and outbound notifications as audio in Nexmo Media. The four endpoints support listing the catalogue, inspecting an individual prompt, renaming prompts when scripts change, and removing retired prompts. The Voice NCCO references each prompt by its id.

GET / to list current prompts, then PUT /:id/info on the relevant id with a new title field.

Recording retention enforcement

Compliance teams enforce retention windows on call recordings stored by Nexmo Voice. Periodic GET / pulls recording metadata; DELETE /:id removes anything older than the retention threshold. Because the API only exposes management - not playback - sensitive audio never moves through the application during cleanup.

GET / with a created-before filter, iterate the response, and DELETE /:id for each id.

Inventory check by an AI agent

An AI agent asked 'what audio prompts do I have on Nexmo?' lists items via Jentic, fetches each item's metadata, and returns a summary. Search by intent, load the operation, execute - no manual URL construction or pagination logic in the agent.

Search Jentic for 'list nexmo media items', load GET /, execute, then GET /:id/info per item to enrich the list with titles and mime types.

Key Endpoints

4 endpoints — jentic publishes the only available openapi specification for nexmo media api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/

List and search media items

GET

/:id/info

Retrieve metadata for a media item

PUT

/:id/info

Update metadata for a media item

DELETE

/:id

Delete a media item

GET

/

List and search media items

GET

/:id/info

Retrieve metadata for a media item

PUT

/:id/info

Update metadata for a media item

DELETE

/:id

Delete a media item

Jentic AI Readiness Score

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

M

Media API

- AI-Ready (A-)
78/100
100
Foundational Compliance
72
Developer Experience & Jentic Compatibility
55
AI-Readiness & Agent Experience
94
Agent Usability
100
Security
100
AI Discoverability
Powered by JenticScoring Framework 1.0.0 | Scoring Engine 0.4.0
Show dimension breakdown
100

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: A+Signals: 4
99%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

100%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

100%

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

72

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: A-Signals: 4
61%

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

25%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

100%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

55

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: CSignals: 4
63%

Description Coverage

Coverage of descriptions across API elements.

0%

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

100%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

57%

Summary Coverage

Coverage of summaries across operations/tags/info.

94

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1
94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

100

Security

Trust, risk posture, and security compliance.

Grade: A+Signals: 1
100%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

100

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: A+Signals: 1
100%

Descriptive Richness

Clarity and depth of descriptions across API elements.

View full reportHow the score is calculatedMore about the dimensions

Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

Score your own APIScoring CLI agent skill
npx @jentic/api-scorecard-cli score <openapi-url>

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the Nexmo Media API by hand means minting a JWT from your Application signing key for each call and pointing requests at the api.nexmo.com/v3/media host to reach items already in your media bucket. Through Jentic you install once, import the Media API from the API Directory, store the Application private key once, and your agent calls it.

Permission scoping

The Media API puts the media item id in the URL path (/:id/info, /:id), so a rule can pin your agent to one media item: it can read that item's info and update its metadata. You choose the operations it may call, so deleting an item is not included unless you add it.

Credential isolation

Your Vonage Application private key is stored once, encrypted, by your own Jentic One instance and used to mint per-call JWTs at execution time. The key never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'update metadata on a Nexmo media item' or 'list stored media', and Jentic returns the matching Media API operation with its parameter schema so the agent calls the right endpoint without browsing the reference docs.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Nexmo Application API v2

→

Manages applications whose Voice flows play and record these media items

Use Application API to manage the app; use Media to curate the audio it plays or records.

Alternative

Twilio API

→

Twilio Recordings and Media resources offer comparable audio storage for voice apps

Pick Twilio when the call traffic already runs on Twilio and a single vendor is preferred.

Alternative

Plivo

→

Plivo's Recordings API covers similar lifecycle management for voice audio

Choose Plivo if pricing on recording storage suits the workload better.

FAQs

Specific to using Nexmo Media API through Jentic.

Why is there no official OpenAPI spec for Nexmo Media API?

Vonage (formerly Nexmo) does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Nexmo Media API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

What authentication does the Nexmo Media API use?

The OpenAPI spec does not declare a securityScheme, but in practice the Vonage Media service requires application-scoped JWT bearer authentication. Through Jentic the JWT is minted from the encrypted private key per call, so the agent never sees the signing material.

Can I create or upload media items via this API?

No. The four endpoints handle listing, retrieving, updating, and deleting items. Uploads use a separate Vonage upload mechanism, and Voice writes recordings into the bucket automatically when calls are recorded.

What are the rate limits for the Nexmo Media API?

The OpenAPI spec does not declare rate limits for /v3/media. Account-level throttles apply; the metadata endpoints are typically called at low volume relative to message or voice traffic.

How do I delete an old call recording through Jentic?

Search Jentic for 'delete a nexmo media item', load DELETE /:id, and execute with the recording id. Use GET / first with a date filter to find candidate ids.

How does the media-api slug differ from the media slug?

Both slugs index the same /v3/media service with the same four endpoints. The duplication is from the original spec ingest; either slug points to the same operations and base URL.

Can I limit what my agent is allowed to do with the Nexmo Media API?

Yes. Because you run Jentic One yourself, your own rules decide which of the four operations the agent may call, so you can allow it to list items with GET / and read metadata with GET /:id/info while withholding PUT /:id/info and DELETE /:id. Since the media item id sits in the URL path, a rule can also pin the agent to a single item, letting it read and update that item's metadata only. Deleting an item is never available unless you explicitly grant it.

GET STARTED

Start building with Nexmo Media API

Explore with Jentic One
View OpenAPI Document