CreateMessageRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/n0t1fy-dev/json-schema/n0t1fy-dev-create-message-request-schema.json",
  "title": "CreateMessageRequest",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/n0t1fy-dev-api-openapi.json#/components/schemas/CreateMessageRequest",
  "properties": {
    "to": {
      "type": "string",
      "title": "To",
      "description": "Recipient in E.164 format: `+9955` followed by eight digits. No other country or format is accepted, and numbers are never normalized on your behalf."
    },
    "template": {
      "type": "string",
      "title": "Template",
      "description": "Which message to send. Message text is never free-form: every message is rendered from one of these templates.\n\n- `verification_code` (`code`): Your verification code is {code}. Do not share it with anyone.\n- `login_code` (`code`): Your sign-in code is {code}. If you did not request it, ignore this message.\n- `password_reset_code` (`code`, `minutes`): Your password reset code is {code}. It expires in {minutes} minutes.\n- `service_down` (`service`): Alert: {service} is down. Team only.\n- `service_up` (`service`): Resolved: {service} is up again. Team only.\n- `incident_opened` (`incident`): Urgent: incident {incident} needs attention. Team only.\n- `support_ticket_urgent` (`ticket`): Urgent: support ticket {ticket} is waiting for a reply. Team only.\n- `job_failed` (`job`): Failed: scheduled job {job} did not finish. Team only.\n- `agent_alert` (`agent`, `count`): {agent}: {count} new updates. Check your app. Team only.\n\nTeam templates go only to numbers confirmed on the project's team on the dashboard (a test key: the test numbers only); any other number answers `403 recipient_not_on_team`. Every template, its blanks and who it may go to: /templates."
    },
    "variables": {
      "additionalProperties": true,
      "type": "object",
      "title": "Variables",
      "description": "Values for the template's placeholders, all as JSON strings. A `code` is 4 to 8 digits; `minutes` is 1 to 999; an `incident` or `ticket` 1 to 8 digits; a `count` 1 to 99; an `agent` `your_agent` or `ai_assistant`; a `service` or `job` a name on the project's team page (a live key). Values that look like a link, a web address, or a phone number are refused."
    },
    "locale": {
      "type": "string",
      "enum": [
        "ka",
        "en"
      ],
      "title": "Locale",
      "description": "Language of the message: `ka` (Georgian, the default) or `en`.",
      "default": "ka"
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "to",
    "template",
    "variables"
  ]
}