Skip to content
/Registrations

Message Templates (0.0.14)

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
Download OpenAPI description
Download PDF
Overview
License
RUCKUS Cloud Privacy Policy
Languages
Servers
RUCKUS One API host for North American region.
https://api.ruckus.cloud
RUCKUS One API host for European region.
https://api.eu.ruckus.cloud
RUCKUS One API host for Asian region.
https://api.asia.ruckus.cloud

Variables

Retrieve variables available to templates within the given template scope.

Operations

Template Registrations

Retrieve template registrations.

Operations

Template Scope

Retrieve information about the template scope.

Operations

Registrations

Manage template registrations.

Operations

Retrieve All Registrations

Request

Returns all registrations within the given template scope.

Path
templateScopeIdstring(uuid)required

Template Scope ID

Query
sizeany

Page size

pageany

The page to retrieve (starts at zero).

sortany

The field name to sort and the sort order (asc or desc) comma separated. Sortable fields are: id, templateId, usageLocalizationKey, usageDescriptionFieldOne, usageDescriptionFieldTwo

No request payload

Responses

The list of registrations within the template scope.

Body
pagingobject(Page Information)

The paging information for this response.

contentArray of objects(Registration)

The content list of the data.

_linksobject(Links)
Response
{
  "paging": {
    "totalCount": 0,
    "page": 0,
    "pageSize": 0,
    "pageCount": 0
  },
  "content": [
    { … }
  ],
  "_links": {
    "property1": { … },
    "property2": { … }
  }
}

Retrieve Registration

Request

Returns the registration for the given ID.

Path
templateScopeIdstring(uuid)required

Template Scope ID

registrationIdstringrequired

Registration ID

No request payload

Responses

The registration.

Body
idstringread-only

The registration ID. This is any string from 5 to 255 characters.

templateIdstring(uuid)required

The ID of the template this registration references.

usageLocalizationKeystring

A key which can be used by a user interface to locate a localized description of where the referenced template is being used.

usageDescriptionFieldOnestring

A user specified string that can be placed into the localized description.

usageDescriptionFieldTwostring

A second user specified string that can be placed into the localized description.

_linksobject(Links)
Response
{
  "id": "string",
  "templateId": "196100ac-4eec-4fb6-a7f7-86c8b584771d",
  "usageLocalizationKey": "string",
  "usageDescriptionFieldOne": "string",
  "usageDescriptionFieldTwo": "string",
  "_links": {
    "property1": { … },
    "property2": { … }
  }
}

Manage Templates

Manage Templates.

Operations