Any other language

Every operation is one POST

The operation name is the path: email.send is POST /email/send, auth.signin.start is POST /auth/signin/start. The body is the input object. There is no other shape to learn.The reply is { activityId, result }. A refusal is { error: { code, message, fix } } with a meaningful status.

# Python, with nothing but requests
import os, requests

r = requests.post(
    "https://platform.trylath.com/email/send",
    headers={"Authorization": f"Bearer {os.environ['LATH_API_KEY']}"},
    json={"to": "you@example.com", "subject": "Hello", "text": "First one."},
)
r.raise_for_status()
print(r.json()["result"]["status"])

Generate a client from the OpenAPI document

The document is generated from the same operation registry as the REST routes, so a generated client is as current as the API. openapi-generator covers most languages; most people need nothing more than this.

curl -o lath.json https://platform.trylath.com/openapi.json

openapi-generator generate -i lath.json -g python -o ./lath-client
openapi-generator generate -i lath.json -g go     -o ./lath-client
openapi-generator generate -i lath.json -g ruby   -o ./lath-client

The two things you would have had for free

Idempotency. Anything not retry-safe takes an Idempotency-Key header. The reference marks which operations those are, and a key reused with different input is refused rather than quietly accepted.Webhook signatures. Lath-Signature is t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>">. Compare in constant time and reject anything older than five minutes. The webhooks guide has the whole scheme in about ten lines, in a form that ports to any language.

curl -X POST https://platform.trylath.com/email/send \
  -H "Authorization: Bearer $LATH_API_KEY" \
  -H "Idempotency-Key: order-1043-receipt" \
  -H "Content-Type: application/json" \
  -d '{"to":"you@example.com","subject":"Receipt","text":"Thanks."}'

import { createLath } from "@trylath/sdk";

const lath = createLath({ key: process.env.LATH_API_KEY });

const { result } = await lath.email.send({
  to: "you@example.com",
  subject: "Receipt",
  text: "Thanks.",
}, { idempotencyKey: "order-1043-receipt" });

lath email send \
  --to you@example.com \
  --subject Receipt \
  --text Thanks. \
  --idempotency-key order-1043-receipt

And the CLI works anywhere

npx @trylath/cli needs Node on the machine but nothing in your project, which makes it a reasonable way to script Lath from a Makefile, a CI job or a language with no client.

npx @trylath/cli email send --to you@example.com --subject Hi --text Hello

Overview

Get started

Frameworks

Sending

Platform

Surfaces

Any other language