Billing

Write time line descriptions

POSThttps://paysuitett.com/api/v1/billing/descriptions

Uses the same avoid-names list and optional AI writer as the app. Without a server Claude key, enabled is false and every line receives its plain fallback. Unknown fields are rejected.

Access. Master key, or a personal key held by an owner/admin or accountant. The business must have the invoices service. Runs as the holder under their row-level security.

Body

A JSON object. Fields marked required must be sent.

periodstringrequired: Service period text.
clientNamesarray: Internal client names to avoid.
linesarrayrequired: Up to 100 {key, title, hours, taskTitles} objects; up to 12 task titles each.

Response

200 with a JSON body, as in the example.

curl -X POST "https://paysuitett.com/api/v1/billing/descriptions" \
  -H "Authorization: Bearer $PAYSUITETT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period":"1–14 Oct 2026","lines":[{"key":"all","title":"Development","hours":2,"taskTitles":["Updated checkout"]}]}'

Success

{
  "descriptions": {
    "all": {
      "description": "Development: Updated checkout",
      "fallback": true
    }
  },
  "enabled": false
}