Complete documentation for Pinot platform APIs. All endpoints require API key authentication.
Generate secure magic links for email authentication
Verify magic link tokens and redirect users
Store notifications for users
Check API health and status
Get OpenAPI specification
All API endpoints require authentication using an API key. Include the key in the X-API-Key header.
curl -X POST https://api.pinot.dev/api/v1/endpoint \
-H "Content-Type: application/json" \
-H "X-API-Key: your-api-key-here" \
-d '{"key": "value"}'
# Generate magic link
curl -X POST https://api.pinot.dev/api/v1/auth/magic-link/generate \
-H "Content-Type: application/json" \
-H "X-API-Key: your-api-key" \
-d '{"email": "user@example.com", "language": "en"}'
# Response
{
"success": true,
"magicLinkUrl": "https://api.pinot.dev/verify?token=abc123",
"message": "Magic link generated successfully"
}
# Create notification
curl -X POST https://api.pinot.dev/api/v1/notifications \
-H "Content-Type: application/json" \
-H "X-API-Key: your-api-key" \
-d '{
"userId": "user-123",
"eventType": "invoice",
"eventId": "inv-456",
"title": "New Invoice",
"message": "Invoice #456 is ready",
"language": "en"
}'
# Response
{
"success": true,
"notificationId": "abc-123-def-456"
}
Official SDKs and libraries for Pinot API:
Email us at support@pinot.dev
Check system status at status.pinot.dev