Overview

The Message Template API provides the ability to create custom messaging (email, sms) templates that can be used to communicate with network users.

What This API Does

• Create and manage message templates: Allows the creation and management of message templates within specific categories and template scopes that can be used for communication.
• Register usages of templates: Registrations can be created to associated an external resource with a specific template using a custom ID.

Technical Details

• Content Types: Supports application/json and application/vnd.ruckus.v1+json
• API Version: v0.0.14
• Data Formats: JSON with HATEOAS links for resource navigation
• Pagination: Standard pagination with configurable page sizes

Example Use Case

A custom template can be created for use when a new user is assigned a unit in property management. This allows for custom branding or information to be provided to network users.

Authentication

All API calls require valid authentication via Bearer token in Authorization header. Include the JWT token in the Authorization: Bearer <token> header.

Error Handling

The API uses standard HTTP status codes with detailed error messages in the response body.

Common Error Responses

All endpoints may return these common error responses:

• 400 Bad Request: Invalid input data or validation errors
• 401 Unauthorized: Missing or invalid authentication
• 403 Forbidden: Insufficient permissions
• 404 Not Found: Requested resource doesn't exist
• 409 Conflict: Resource conflict (e.g., duplicate names)
• 422 Unprocessable Entity: Business rule violations
• 500 Internal Server Error: Unexpected server errors