VoiceStamp API Reference

Complete REST API for creating, managing, and sharing voice-annotated content. Build powerful voice applications with our comprehensive developer tools.

169

API Endpoints

Email & SMS Templates

99.9%

Uptime SLA

Base URL

https://voicestamp.vps.webdock.cloud/api/v1

Quick Start

Get API Token

Authenticate with email/SMS verification to get your Bearer token

POST /api/v1/auth/login

Create VoiceStamp

Create a draft VoiceStamp to start uploading files

POST /api/v1/security/vst/draft

Upload Content

Upload audio, images, and other assets to your VoiceStamp

POST /api/v1/security/vst/{id}/audio

Share & Collaborate

Share your VoiceStamp via email, SMS, or public link

POST /api/v1/voicestamps/{id}/share

API Categories

Authentication

8 endpoints

Secure token-based authentication with email/SMS verification

Featured:

• POST /api/v1/auth/login

• POST /api/v1/auth/verify-code

• POST /api/v1/auth/refresh

View Documentation →

VoiceStamps

32 endpoints

Complete CRUD operations, file management, sharing, and conversion

Featured:

• POST /api/v1/security/vst/draft

• POST /api/v1/voicestamps/{id}/share

• GET /api/v1/voicestamps

View Documentation →

Templates

37 endpoints• 37 templates

Database-driven email and SMS templates with variable substitution

Featured:

• Email Template #100: VoiceStamp Share

• SMS Template #100: VoiceStamp Share

• Template #2: Verification Code

View Documentation →

Email API

15 endpoints

Send emails, manage templates, track deliveries and statistics

Featured:

• POST /api/v1/email/send

• GET /api/v1/email/templates

• GET /api/v1/email/stats

View Documentation →

SMS API

35 endpoints

Send SMS, verification codes, manage providers and templates

Featured:

• POST /api/v1/sms/send

• POST /api/v1/sms/verification/send

• GET /api/v1/sms/templates

View Documentation →

Security

27 endpoints

Token generation, validation, file access, and security controls

Featured:

• POST /api/v1/security/token

• POST /api/v1/security/validate

• POST /api/v1/security/generate-file-token

View Documentation →

Authentication

VoiceStamp uses Bearer token authentication. Each API request requires an Authorization header with a valid token.

Get Token

POST https://voicestamp.vps.webdock.cloud/api/v1/auth/login
Content-Type: application/json

{
  "email": "user@example.com"
}

Use Token

GET https://voicestamp.vps.webdock.cloud/api/v1/voicestamps
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json

Rate Limits

1000

Requests per hour

General API endpoints

100

Uploads per hour

File upload endpoints

Emails/SMS per hour

Messaging endpoints

Response Format

Success Response

HTTP 200 OK
{
  "success": true,
  "data": {
    "id": 12345,
    "title": "My VoiceStamp",
    "status": "completed"
  },
  "message": "Operation successful"
}

Error Response

HTTP 400 Bad Request
{
  "success": false,
  "error": "validation_failed",
  "message": "Invalid request data",
  "errors": {
    "title": ["Title is required"]
  }
}