‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
‌
Alayn — AI Operating System for Hospitality
‌
ALAYN AI DEVELOPER PLATFORM

Developer API & OpenAPI Spec

Integrate Alayn AI with point-of-sale hardware, third-party delivery platforms, custom mobile apps, and accounting ERPs with 100% typed schema precision.

openapi.json (OpenAPI 3.1)llms.txt (Agent Guidance)llms-full.txt (Full RAG)
OFFICIAL CLI TOOL

Automate with the Alayn CLI (@alayn/cli)

The official command-line interface lets developers, agents, and DevOps pipelines script restaurant workflows, sync menus, and tail live KDS orders without building HTTP clients from scratch.

# Install globally via npm

npm install -g @alayn/cli

# Authenticate your terminal

alayn auth login --api-key <YOUR_API_KEY>

# Stream live kitchen orders in real-time

alayn orders stream --outlet 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d

AUTHENTICATION & HEADERS

Base URL & Multi-Tenant Header Scoping

All production API requests must authenticate via Bearer JWT and specify the targeted outlet UUID via the x-outlet-id header.

Base URL: https://api.alaynai.com/v1

Authorization: Bearer <jwt_access_token>

x-outlet-id: 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d

IETF RATE LIMITING

Self-Throttling & Rate Limit Headers

Alayn AI returns standard RFC rate-limiting headers on all API responses so autonomous agents and integrations can self-throttle in real time:

  • RateLimit-Limit: 100 (requests allowed per 60-second window)
  • RateLimit-Remaining: Count of remaining requests in the active window
  • RateLimit-Reset: Seconds until window reset
  • Retry-After: Provided on HTTP 429 responses indicating backoff duration
TYPED ERROR MODEL

RFC 9457 Problem Details for HTTP APIs

All 4xx and 5xx responses conform to the application/problem+json specification, providing machine-readable error codes and structured invalid parameter details:

{
  "type": "https://alaynai.com/errors/validation",
  "title": "Validation Failed",
  "status": 422,
  "detail": "Quantity for item must be greater than zero.",
  "code": "ERR_PAYLOAD_VALIDATION",
  "invalidParams": [
    { "name": "items[0].quantity", "reason": "Must be >= 1" }
  ]
}
API LIFECYCLE

Deprecation & Sunset Policy

Alayn AI maintains a minimum 12-month sunset window for deprecated API operations. When an endpoint or property is flagged for deprecation:

  1. A Deprecation: @<unix_timestamp> header is attached to responses.
  2. A Sunset: <http_date> header announces the exact termination date.
  3. Active API key owners receive automated developer alerts via email and webhook telemetry.
Alayn

The Intelligent Operating System for Hospitality. Built for scale, designed for clarity.

Platform

About UsBook a DemoDeveloper APIsLog inSign up

Connect

Contact Salesinfo@alaynai.comllms.txtInstagram

Legal & Trust

Privacy PolicyTerms of ServiceCookie PolicySecurity & Data ProtectionResponsible AICorporate Information

© 2026 Alayn AI (BRAHM Global Holdings). All Rights Reserved.

AboutContactPrivacyAPIs