Decision templates

Templates are ready-made questions for common tasks. Send a template and your text to POST /v1/decide and you get a decision without writing a question or options.

Available templates

Template	Type	Options	What it decides
`moderation`	choice	`safe`, `toxic`	Flags insults, harassment, hate speech and threats.
`spam`	choice	`spam`, `legit`	Separates spam, scams and phishing from genuine messages.
`support_intent`	choice	`question`, `bug_report`, `refund`, `cancellation`, `feature_request`, `praise`, `other`	What the customer wants from a support ticket.
`routing`	choice	`billing`, `technical`, `sales`, `other`	Which team should handle a message. Pass your own teams in `options`.
`sentiment`	choice	`positive`, `neutral`, `negative`	The tone of a message.
`priority`	score	`low`, `normal`, `high`, `urgent`	How urgent a message is.
`language`	choice	ISO 639-1 codes	Which language the text is written in. See Language detection.

Each template is a single decision and is billed like any other: $0.000005 per request.

How the options are defined

The model sees a short description of each option, not just its name. These descriptions decide where the borderline cases go:

Template	Option	Description given to the model
`moderation`	`safe`	polite, neutral or harshly critical content about a product, service or idea, without attacking a person
	`toxic`	insults or slurs aimed at a person, harassment, hate speech, threats of violence or revenge, telling someone to hurt themselves
`spam`	`spam`	unsolicited advertising, scam, phishing, fake prizes, suspicious links
	`legit`	genuine message: question, complaint, refund request, bug report or thanks
`support_intent`	`question`	asks for information or instructions
	`bug_report`	reports an error or something not working
	`refund`	wants money back or reports a wrong charge
	`cancellation`	wants to cancel or close the account
	`feature_request`	asks for a new feature or improvement
	`praise`	says thanks or compliments
	`other`	anything else
`routing`	`billing`	existing charges, invoices, payments, refunds, billing details
	`technical`	bugs, errors, outages, crashes, API and integrations
	`sales`	prices of plans, quotes, buying, upgrading, new contracts
	`other`	jobs, office locations, partnerships and anything else

sentiment and priority use the option names alone. If a template's definitions don't match your policy, override them as shown below.

Example

POST /v1/decide

curl https://layahost.com/v1/decide \
  -H "Authorization: Bearer $LAYAHOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Congratulations! You won a $500 gift card. Claim it now at bit.ly/prize-claim",
    "template": "spam"
  }'

Response · 200

{
  "decision": "spam",
  "confidence": 0.4058,
  "probabilities": {
    "spam": 0.8562,
    "legit": 0.1438
  },
  "template": "spam",
  "model": "laya-english",
  "usage": {
    "decisions": 1,
    "input_tokens": 83,
    "cost_micros": 5,
    "cost_usd": 5.0e-6
  },
  "latency_ms": 130.72,
  "request_id": "req_y4k2bsiy6d7gatbik1y82rnk"
}

Override a template

Any template accepts the same question and options fields as a custom question. They replace the template's own, so you can keep the template's slug in your logs while using your own wording or categories:

options as a list of names or as an object of names and descriptions. For routing, pass your own teams.
question to reword the question.

There is a full example in POST /v1/decide. Wording changes can move results a lot, so test your version on real messages.

Language detection

The language template does not use Laya. It runs a dedicated language detector and returns ISO 639-1 codes. Without options, it considers every supported language and returns the five most likely:

POST /v1/decide

curl https://layahost.com/v1/decide \
  -H "Authorization: Bearer $LAYAHOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Dzień dobry, mam pytanie o fakturę.",
    "template": "language"
  }'

Response · 200

{
  "decision": "pl",
  "confidence": 0.919,
  "probabilities": {
    "pl": 0.919,
    "sk": 0.0184,
    "sv": 0.0138,
    "da": 0.0084,
    "nb": 0.005
  },
  "template": "language",
  "model": "lingua",
  "usage": {
    "decisions": 1,
    "input_tokens": 0,
    "cost_micros": 5,
    "cost_usd": 5.0e-6
  },
  "latency_ms": 44.7,
  "request_id": "req_aelx2cghpfzvdnoz7nriwqzn"
}

Pass options with the codes you expect to choose among them only. The probabilities are then normalised over your list:

POST /v1/decide

curl https://layahost.com/v1/decide \
  -H "Authorization: Bearer $LAYAHOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Dzień dobry, mam pytanie o fakturę.",
    "template": "language",
    "options": ["en", "pl", "de"]
  }'

Response · 200

{
  "decision": "pl",
  "confidence": 0.9964,
  "probabilities": {
    "pl": 0.9964,
    "de": 0.0029,
    "en": 0.0007
  },
  "template": "language",
  "model": "lingua",
  "usage": {
    "decisions": 1,
    "input_tokens": 0,
    "cost_micros": 5,
    "cost_usd": 5.0e-6
  },
  "latency_ms": 0.84,
  "request_id": "req_igquswea95s7kdti2jwezefc"
}

Supported codes: en, pl, de, fr, es, it, pt, nl, uk, cs, sk, ru, sv, da, nb, fi, hu, ro, tr, ja, zh, ko, ar, hi, el, bg, hr, lt, lv, et, sl, sr, he, vi and id. GET /v1/templates lists the same codes.

confidence is the probability of the detected language.
model is lingua and usage.input_tokens is 0. The model and lang request fields are ignored.
An unsupported code in options returns 422 on ["body", "options"], with the message “Unsupported language codes: xx. See GET /v1/templates.”
Very short texts (a word or two) are hard to identify in any language. Check confidence.

List templates

GET /v1/templates returns every template with its type, option names and an example text. Use it to build a picker or to check what a slug does.

GET /v1/templates

curl https://layahost.com/v1/templates \
  -H "Authorization: Bearer $LAYAHOST_API_KEY"

Response · 200

{
  "templates": [
    {
      "template": "moderation",
      "name": "Moderation",
      "description": "Flags insults, harassment, hate speech and threats.",
      "type": "choice",
      "options": ["safe", "toxic"],
      "example": "You are all idiots and I hope you get fired."
    },
    {
      "template": "spam",
      "name": "Spam",
      "description": "Separates spam and scams from genuine messages.",
      "type": "choice",
      "options": ["spam", "legit"],
      "example": "Earn $5000 a day from home! Message me on WhatsApp."
    },
    {
      "template": "support_intent",
      "name": "Support intent",
      "description": "What the customer wants from a support ticket.",
      "type": "choice",
      "options": ["question", "bug_report", "refund", "cancellation", "feature_request", "praise", "other"],
      "example": "I was charged twice this month, please refund one payment."
    },
    {
      "template": "routing",
      "name": "Routing",
      "description": "Sends a message to the right team. Pass your own departments in \"options\".",
      "type": "choice",
      "options": ["billing", "technical", "sales", "other"],
      "example": "The API returns 502 errors since this morning."
    },
    {
      "template": "sentiment",
      "name": "Sentiment",
      "description": "Positive, neutral or negative tone.",
      "type": "choice",
      "options": ["positive", "neutral", "negative"],
      "example": "Thanks for the quick help, everything works great!"
    },
    {
      "template": "priority",
      "name": "Priority",
      "description": "How urgent a message is, on a 4-level scale.",
      "type": "score",
      "options": ["low", "normal", "high", "urgent"],
      "example": "Our whole checkout is down and we are losing orders right now!"
    },
    {
      "template": "language",
      "name": "Language",
      "description": "Which language the text is written in (ISO 639-1, 35 languages). Pass \"options\" to narrow the list.",
      "type": "choice",
      "options": ["en", "pl", "de", "fr", "es", "it", "pt", "nl", "uk", "cs", "sk", "ru", "sv", "da", "nb", "fi", "hu", "ro", "tr", "ja", "zh", "ko", "ar", "hi", "el", "bg", "hr", "lt", "lv", "et", "sl", "sr", "he", "vi", "id"],
      "example": "Dzień dobry, mam pytanie o fakturę."
    }
  ]
}

Listing templates is free and counts towards your rate limit like any other request.