# Vonage Secret Management API

**Canonical:** https://apis.io/apis/vonage/vonage-secret-management-api/  
**Provider:** Vonage — https://apis.io/providers/vonage/  
**Base URL:** https://rest.nexmo.com  
**Documentation:** https://developer.vonage.com/en/api/sms

Vonage Secret Management API is one of 59 APIs that [Vonage](https://apis.io/providers/vonage/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 74 JSON Schema definitions. Tagged areas include Secret Management. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, and 74 JSON Schemas.

Many of the Vonage APIs are accessed using an API key and secret. It is recommended that you change or "rotate" your secrets from time to time for security purposes. This section provides the API interface for achieving this. Note: to work on secrets for your secondary accounts, you may authenticate with your primary credentials and supply the secondary API keys as URL parameters to these API endpoints.

## Operations (4)

| Method | Path | Summary |
|---|---|---|
| GET | `/accounts/{api_key}/secrets` | Retrieve API secrets |
| POST | `/accounts/{api_key}/secrets` | Create API secret |
| GET | `/accounts/{api_key}/secrets/{secret_id}` | Retrieve API secret |
| DELETE | `/accounts/{api_key}/secrets/{secret_id}` | Revoke API secret |

## Machine-readable artifacts (98)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/openapi/vonage-secret-management-api-openapi.yml
- **Documentation** — https://developer.vonage.com/en/api/sms
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-new-message-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-smsxml-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-sms-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-error-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-error-xml-schema.json
- **Documentation** — https://developer.vonage.com/en/api/messages
- **Documentation** — https://developer.vonage.com/en/api/voice
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/asyncapi/vonage-asyncapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-get-call-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-get-calls-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-start-talk-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-update-call-request-transfer-ncco-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-create-call-request-answer-url-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-update-call-request-transfer-answer-url-schema.json
- **Documentation** — https://developer.vonage.com/en/api/verify
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-verify-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-search-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-psd2-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-request-error-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-control-error-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-check-error-response-schema.json
- **Documentation** — https://developer.vonage.com/en/api/verify.v2
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-list-fragments-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-list-templates-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-template-fragment-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-template-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-code-submit-success-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-silent-auth-confirmation-success-schema.json
- **Documentation** — https://developer.vonage.com/en/api/numbers
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-number-details-update-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-number-details-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-available-numbers-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-inbound-numbers-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-response-schema.json
- **Documentation** — https://developer.vonage.com/en/api/application.v2
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-application-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-video-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/vonage/refs/heads/main/json-schema/vonage-user-channels-schema.json
- …and 58 more, listed in full on the page.

## Other Vonage APIs (12)

- [Vonage Account API](https://apis.io/apis/vonage/vonage-account-api/)
- [Vonage Advanced API](https://apis.io/apis/vonage/vonage-advanced-api/)
- [Vonage Application API](https://apis.io/apis/vonage/vonage-application-api/)
- [Vonage Applications API](https://apis.io/apis/vonage/vonage-applications-api/)
- [Vonage Archives API](https://apis.io/apis/vonage/vonage-archives-api/)
- [Vonage Audio Connector API](https://apis.io/apis/vonage/vonage-audio-connector-api/)
- [Vonage Balance API](https://apis.io/apis/vonage/vonage-balance-api/)
- [Vonage Basic API](https://apis.io/apis/vonage/vonage-basic-api/)
- [Vonage Broadcast API](https://apis.io/apis/vonage/vonage-broadcast-api/)
- [Vonage Calls API](https://apis.io/apis/vonage/vonage-calls-api/)
- [Vonage Configuration API](https://apis.io/apis/vonage/vonage-configuration-api/)
- [Vonage Conversation API](https://apis.io/apis/vonage/vonage-conversation-api/)

## Tags

Secret Management

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/vonage/vonage-secret-management-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/vonage/.
