{"openapi":"3.1.0","info":{"title":"Glossa API","version":"1.0.0","description":"Read your church's Glossa data from your own software.\n\n**Authentication.** Create an API key in Settings → API keys (or ask support) and send it as `Authorization: Bearer glk_live_…`. Keys are secret: keep them on a server, never in a public web page.\n\n**Limits.** 300 requests per minute per key (`RateLimit-*` headers on every response). Poll a service's status every 5 seconds or slower.\n\n**Scope.** The API is read-only: there is no endpoint to start or stop a session yet. For hands-free start and stop, send an RTMP feed to the service's stream key: the session starts when the encoder connects and ends when it disconnects.\n\n**Webhooks.** Register an endpoint in Settings → Webhooks and Glossa POSTs the events listed under *Webhooks* below (sessions starting and ending, usage, listeners joining and leaving, translated sentences). Every delivery carries `Glossa-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256(secret, \"<t>.<raw body>\")>` plus `Glossa-Event-Id`, `Glossa-Event-Type`, `Glossa-Delivery-Id` and `Glossa-Attempt`; verify the signature over the raw body and reject timestamps older than 5 minutes."},"servers":[{"url":"https://api.glossa.live/v1"}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"glk_live_…","description":"A Glossa API key, created in Settings → API keys."}},"schemas":{"WebhookEvent_session_started":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Event id, the same for every endpoint that receives the event (use it to de-duplicate)"},"type":{"type":"string","enum":["session.started"]},"created_at":{"type":"string","description":"When the event happened (UTC)"},"api_version":{"type":"string","enum":["1"]},"data":{"type":"object","properties":{"service":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"}},"required":["id","title"],"description":"The service the event belongs to"},"session":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"started_at":{"type":"string"},"source":{"type":["string","null"],"description":"`microphone`, `rtmp`, `srt` or `url`"},"speaker_language":{"type":["string","null"]}},"required":["id","started_at","source","speaker_language"]},"listeners":{"type":"object","properties":{"total":{"type":"integer"},"by_language":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"count":{"type":"integer"}},"required":["code","count"]}}},"required":["total","by_language"],"description":"Who is listening right now, after this event; caption overlays count too"}},"required":["service","session","listeners"]}},"required":["id","type","created_at","api_version","data"]},"WebhookEvent_session_ended":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Event id, the same for every endpoint that receives the event (use it to de-duplicate)"},"type":{"type":"string","enum":["session.ended"]},"created_at":{"type":"string","description":"When the event happened (UTC)"},"api_version":{"type":"string","enum":["1"]},"data":{"type":"object","properties":{"service":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"}},"required":["id","title"],"description":"The service the event belongs to"},"session":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"started_at":{"type":["string","null"]},"ended_at":{"type":"string"},"duration_seconds":{"type":["integer","null"]},"source":{"type":["string","null"]},"speaker_language":{"type":["string","null"]},"peak_listeners":{"type":"integer"},"unique_listeners":{"type":"integer"},"end_reason":{"type":["string","null"],"description":"For example `time_limit`; null when the operator stopped the stream"}},"required":["id","started_at","ended_at","duration_seconds","source","speaker_language","peak_listeners","unique_listeners","end_reason"]}},"required":["service","session"]}},"required":["id","type","created_at","api_version","data"]},"WebhookEvent_session_usage_ready":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Event id, the same for every endpoint that receives the event (use it to de-duplicate)"},"type":{"type":"string","enum":["session.usage_ready"]},"created_at":{"type":"string","description":"When the event happened (UTC)"},"api_version":{"type":"string","enum":["1"]},"data":{"type":"object","properties":{"service":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"}},"required":["id","title"],"description":"The service the event belongs to"},"session":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"started_at":{"type":"string"},"ended_at":{"type":["string","null"]},"duration_seconds":{"type":["integer","null"]}},"required":["id","started_at","ended_at","duration_seconds"]},"usage":{"type":"object","properties":{"billable_minutes":{"type":"number"},"cost_usd":{"type":["number","null"],"description":"Pay-as-you-go cost; null on a subscription"},"languages":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"minutes":{"type":"number"},"listeners":{"type":"integer"}},"required":["code","minutes","listeners"]}}},"required":["billable_minutes","cost_usd","languages"]}},"required":["service","session","usage"]}},"required":["id","type","created_at","api_version","data"]},"WebhookEvent_listener_joined":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Event id, the same for every endpoint that receives the event (use it to de-duplicate)"},"type":{"type":"string","enum":["listener.joined"]},"created_at":{"type":"string","description":"When the event happened (UTC)"},"api_version":{"type":"string","enum":["1"]},"data":{"type":"object","properties":{"service":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"}},"required":["id","title"],"description":"The service the event belongs to"},"session":{"type":"object","properties":{"id":{"type":"string","format":"uuid"}},"required":["id"]},"listener":{"type":"object","properties":{"id":{"type":"string","description":"Stable for the connection (a language switch is a listener.left then a listener.joined with the same id); never an IP or device"},"language":{"type":"string"},"joined_at":{"type":"string"}},"required":["id","language","joined_at"]},"listeners":{"type":"object","properties":{"total":{"type":"integer"},"by_language":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"count":{"type":"integer"}},"required":["code","count"]}}},"required":["total","by_language"],"description":"Who is listening right now, after this event; caption overlays count too"}},"required":["service","session","listener","listeners"]}},"required":["id","type","created_at","api_version","data"]},"WebhookEvent_listener_left":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Event id, the same for every endpoint that receives the event (use it to de-duplicate)"},"type":{"type":"string","enum":["listener.left"]},"created_at":{"type":"string","description":"When the event happened (UTC)"},"api_version":{"type":"string","enum":["1"]},"data":{"type":"object","properties":{"service":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"}},"required":["id","title"],"description":"The service the event belongs to"},"session":{"type":"object","properties":{"id":{"type":"string","format":"uuid"}},"required":["id"]},"listener":{"type":"object","properties":{"id":{"type":"string"},"language":{"type":"string"},"joined_at":{"type":["string","null"]},"left_at":{"type":"string"},"duration_seconds":{"type":["integer","null"]}},"required":["id","language","joined_at","left_at","duration_seconds"]},"listeners":{"type":"object","properties":{"total":{"type":"integer"},"by_language":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"count":{"type":"integer"}},"required":["code","count"]}}},"required":["total","by_language"],"description":"Who is listening right now, after this event; caption overlays count too"}},"required":["service","session","listener","listeners"]}},"required":["id","type","created_at","api_version","data"]},"WebhookEvent_translation_utterance":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Event id, the same for every endpoint that receives the event (use it to de-duplicate)"},"type":{"type":"string","enum":["translation.utterance"]},"created_at":{"type":"string","description":"When the event happened (UTC)"},"api_version":{"type":"string","enum":["1"]},"data":{"type":"object","properties":{"service":{"type":"object","properties":{"id":{"type":"string","format":"uuid"}},"required":["id"]},"session":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"}},"required":["id"]},"sequence":{"type":"integer","description":"Per endpoint and service, in utterance order"},"text":{"type":"string","description":"The original utterance"},"translations":{"type":"object","additionalProperties":{"type":"string"},"description":"Language code → translated text (the languages the endpoint asked for)"},"audio":{"type":"object","additionalProperties":{"type":"string"},"description":"Language code → base64 MP3, only when the endpoint asked for audio"}},"required":["service","session","sequence","text","translations"]}},"required":["id","type","created_at","api_version","data"]},"WebhookEvent_webhook_test":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Event id, the same for every endpoint that receives the event (use it to de-duplicate)"},"type":{"type":"string","enum":["webhook.test"]},"created_at":{"type":"string","description":"When the event happened (UTC)"},"api_version":{"type":"string","enum":["1"]},"data":{"type":"object","properties":{"service":{"type":"null"},"message":{"type":"string"}},"required":["service","message"]}},"required":["id","type","created_at","api_version","data"]},"Me":{"type":"object","properties":{"church":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":["string","null"]},"slug":{"type":["string","null"],"description":"The church page slug (glossa.live/<slug>)"},"page_url":{"type":["string","null"]}},"required":["id","name","slug","page_url"]},"plan":{"type":"object","properties":{"type":{"type":"string","enum":["payg","subscription","trial"],"description":"`trial` is a subscription in its trial period"},"name":{"type":"string","example":"Standard"},"billing_interval":{"type":["string","null"],"example":"month"},"period_start":{"type":["string","null"]},"period_end":{"type":["string","null"]},"hours_included":{"type":["number","null"],"description":"Language-hours included per month (subscriptions only)"},"hours_used":{"type":["number","null"]},"hours_remaining":{"type":["number","null"]}},"required":["type","name","billing_interval","period_start","period_end","hours_included","hours_used","hours_remaining"]},"balance_usd":{"type":["number","null"],"description":"Pay-as-you-go ledger balance in USD (null on a subscription). This is the account balance, not a live estimate of unbilled usage."},"key":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"scopes":{"type":"array","items":{"type":"string","enum":["services:read","sessions:read","usage:read","recaps:read","stream_keys:read"]}}},"required":["id","scopes"]}},"required":["church","plan","balance_usd","key"]},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["unauthenticated","insufficient_scope","not_found","invalid_request","rate_limited","internal"]},"message":{"type":"string"},"request_id":{"type":"string","description":"Same value as the Glossa-Request-Id response header"},"details":{}},"required":["code","message"]}},"required":["error"]},"ServiceList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Service"}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"}},"required":["data","page","limit","total"]},"Service":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"speaker_language":{"type":"string","example":"en-US","description":"The language the speaker uses, or `multi`"},"limited_languages":{"type":"array","items":{"type":"string"},"description":"Listener languages this service is limited to; empty means every language is available"},"date":{"type":["string","null"],"example":"2026-10-25"},"time":{"type":["string","null"],"example":"10:00"},"recurring":{"type":"boolean"},"private":{"type":"boolean","description":"Private services are hidden from the church page"},"is_live":{"type":"boolean","description":"Stored live flag; use /services/{id}/status for the authoritative state and listeners"},"urls":{"type":"object","properties":{"listener":{"type":"string","description":"The page listeners open (the QR code target)"},"embed":{"type":"string","description":"Captions-only overlay for OBS, vMix or ProPresenter; always pass ?lang="},"iframe":{"type":"string","description":"The full listener experience for embedding in your own site"}},"required":["listener","embed","iframe"]}},"required":["id","title","speaker_language","limited_languages","date","time","recurring","private","is_live","urls"]},"ServiceDetail":{"allOf":[{"$ref":"#/components/schemas/Service"},{"type":"object","properties":{"max_session_minutes":{"type":["number","null"],"description":"Browser-microphone sessions stop after this many minutes (RTMP sessions have no cap)"},"webhook":{"type":"object","properties":{"enabled":{"type":"boolean"}},"required":["enabled"],"description":"Whether the per-utterance translation webhook is enabled for this service"}},"required":["max_session_minutes","webhook"]}]},"ServiceStatus":{"type":"object","properties":{"service_id":{"type":"string","format":"uuid"},"live":{"type":"boolean"},"basis":{"type":"string","enum":["memory","database"],"description":"`memory`: the owner shard's live state. `database`: only the stored is_live flag said so; listeners unknown."},"source":{"type":["string","null"],"enum":["microphone","rtmp","srt","url","zoom","meeting_bot",null],"description":"Where the audio comes from while live"},"session_id":{"type":["string","null"],"format":"uuid","description":"Use with /sessions/{id} after the session ends"},"started_at":{"type":["string","null"]},"duration_seconds":{"type":["integer","null"]},"listeners":{"type":"object","properties":{"total":{"type":"integer"},"by_language":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"count":{"type":"integer"}},"required":["code","count"]},"description":"Caption overlays (embed) count as listeners too"}},"required":["total","by_language"]},"as_of":{"type":"string","description":"When this snapshot was taken; poll every 5 s or slower"}},"required":["service_id","live","basis","source","session_id","started_at","duration_seconds","listeners","as_of"]},"SessionList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Session"}},"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"}},"required":["data","page","limit","total"]},"Session":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"service_id":{"type":"string","format":"uuid"},"service_title":{"type":"string"},"started_at":{"type":"string"},"ended_at":{"type":["string","null"]},"duration_seconds":{"type":["integer","null"]},"status":{"type":["string","null"],"example":"ended","description":"`live` or `ended`"},"speaker_language":{"type":["string","null"]},"source":{"type":["string","null"],"example":"microphone","description":"`microphone`, `rtmp`, `srt` or `url`"},"peak_listeners":{"type":"integer"},"unique_listeners":{"type":"integer"},"languages":{"type":"array","items":{"type":"string"},"description":"Languages at least one listener used"},"billable_minutes":{"type":["number","null"],"description":"null while the session is live or its usage is still being computed"},"cost_usd":{"type":["number","null"],"description":"Pay-as-you-go cost; null on a subscription or while pending"},"end_reason":{"type":["string","null"],"example":"time_limit","description":"Why the session ended, when recorded (for example `time_limit`)"}},"required":["id","service_id","service_title","started_at","ended_at","duration_seconds","status","speaker_language","source","peak_listeners","unique_listeners","languages","billable_minutes","cost_usd","end_reason"]},"SessionDetail":{"allOf":[{"$ref":"#/components/schemas/Session"},{"type":"object","properties":{"languages_detail":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"minutes":{"type":"number"},"listeners":{"type":"integer"}},"required":["code","minutes","listeners"]}}},"required":["languages_detail"]}]},"Transcript":{"type":"object","properties":{"session_id":{"type":"string","format":"uuid"},"lines":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string"},"original":{"type":["string","null"]},"translations":{"type":"object","additionalProperties":{"type":"string"}}},"required":["at","original","translations"]}},"truncated":{"type":"boolean","description":"true when the session hit the transcript row cap and lines are missing at the end"}},"required":["session_id","lines","truncated"]},"Usage":{"type":"object","properties":{"from":{"type":"string"},"to":{"type":"string"},"group_by":{"type":"string","enum":["day","language","service"]},"rows":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":"The day (YYYY-MM-DD), language code or service id"},"minutes":{"type":"number"},"cost_usd":{"type":["number","null"]}},"required":["key","minutes","cost_usd"]}},"totals":{"type":"object","properties":{"minutes":{"type":"number"},"cost_usd":{"type":["number","null"]}},"required":["minutes","cost_usd"]},"plan":{"type":["object","null"],"properties":{"hours_included":{"type":"number"},"hours_used":{"type":"number"},"hours_remaining":{"type":"number"}},"required":["hours_included","hours_used","hours_remaining"],"description":"Current period of the subscription; null on pay-as-you-go"}},"required":["from","to","group_by","rows","totals","plan"]},"WeeklyRecapList":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/WeeklyRecap"}}},"required":["data"]},"WeeklyRecap":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"weekend":{"type":"string","example":"2026-10-25","description":"The local date of the recapped service"},"language":{"type":["string","null"]},"title":{"type":["string","null"]},"big_idea":{"type":["string","null"]},"quote":{"type":["string","null"]},"caption":{"type":["string","null"],"description":"Ready-to-post social caption"},"hashtags":{"type":"array","items":{"type":"string"}},"scripture_refs":{"type":"array","items":{"type":"string"}},"stats":{"$ref":"#/components/schemas/WeeklyRecapStats"},"files":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","enum":["quote-square.jpg","quote-story.jpg","verse-square.jpg","study-guide.pdf","kids-page.pdf"]},"url":{"type":"string"}},"required":["key","url"]},"description":"Fetch each url (same key) for a 10-minute signed download link"},"email_sent_at":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","weekend","language","title","big_idea","quote","caption","hashtags","scripture_refs","stats","files","email_sent_at","created_at"]},"WeeklyRecapStats":{"type":["object","null"],"properties":{"listeners":{"type":"number"},"languages":{"type":"number"},"minutesLive":{"type":"number"},"phrasesTranslated":{"type":"number"},"byLanguage":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"listeners":{"type":"number"},"phrases":{"type":"number"}},"required":["code"]}}}},"RecapFileUrl":{"type":"object","properties":{"url":{"type":"string"},"expires_in":{"type":"number","enum":[600]}},"required":["url","expires_in"]},"StreamKey":{"type":"object","properties":{"rtmp_url":{"type":"string","enum":["rtmp://stream.glossa.live:1935/live"],"description":"RTMP server URL for your encoder (OBS, vMix, ffmpeg)"},"stream_key":{"type":"string","description":"Stream key for that encoder; the session starts when it connects and ends when it disconnects. Treat it as a secret."},"language":{"type":"string","example":"en-US","description":"The speech language baked into the key"}},"required":["rtmp_url","stream_key","language"]}},"parameters":{}},"paths":{"/me":{"get":{"tags":["Account"],"summary":"Your church, plan and key","description":"The church this key belongs to, its plan and hours, the pay-as-you-go balance, and the scopes of the key in use.","security":[{"ApiKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"church":{"id":"8c1d2e3f-4a5b-4c6d-8e7f-9a0b1c2d3e4f","name":"Grace Church","slug":"grace-church","page_url":"https://glossa.live/grace-church"},"plan":{"type":"subscription","name":"Standard","billing_interval":"month","period_start":"2026-10-13T00:00:00.000Z","period_end":"2026-11-13T00:00:00.000Z","hours_included":25,"hours_used":3.5,"hours_remaining":21.5},"balance_usd":null,"key":{"id":"a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d","scopes":["services:read","sessions:read","usage:read","recaps:read"]}},"schema":{"$ref":"#/components/schemas/Me"}}}},"401":{"description":"Missing, unknown, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such resource for this church","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded; see RateLimit-* and Retry-After headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/services":{"get":{"tags":["Services"],"summary":"List your services","description":"Your church's services (translation rooms), newest scheduled date first. Deleted services are not included.","security":[{"ApiKey":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"default":1,"description":"1-based page number","example":1},"required":false,"description":"1-based page number","name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"default":20,"description":"Items per page, default 20, values above 50 are clamped","example":20},"required":false,"description":"Items per page, default 20, values above 50 are clamped","name":"limit","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":[{"id":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c","title":"Sunday Service","speaker_language":"en-US","limited_languages":["es-ES","pt-BR"],"date":"2026-10-25","time":"10:00","recurring":true,"private":false,"is_live":false,"urls":{"listener":"https://glossa.live/grace-church/3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c","embed":"https://glossa.live/embed/3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c","iframe":"https://glossa.live/iframe/3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c"}}],"page":1,"limit":20,"total":1},"schema":{"$ref":"#/components/schemas/ServiceList"}}}},"400":{"description":"Malformed parameters; details lists the issues","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, unknown, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such resource for this church","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded; see RateLimit-* and Retry-After headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/services/{id}":{"get":{"tags":["Services"],"summary":"One service","description":"The service with its session cap and whether the translation webhook is on. Live state and listeners come from /services/{id}/status.","security":[{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"id":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c","title":"Sunday Service","speaker_language":"en-US","limited_languages":["es-ES","pt-BR"],"date":"2026-10-25","time":"10:00","recurring":true,"private":false,"is_live":false,"urls":{"listener":"https://glossa.live/grace-church/3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c","embed":"https://glossa.live/embed/3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c","iframe":"https://glossa.live/iframe/3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c"},"max_session_minutes":240,"webhook":{"enabled":false}},"schema":{"$ref":"#/components/schemas/ServiceDetail"}}}},"400":{"description":"Malformed parameters; details lists the issues","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, unknown, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such resource for this church","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded; see RateLimit-* and Retry-After headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/services/{id}/status":{"get":{"tags":["Services"],"summary":"Live status and listeners","description":"Whether the service is live right now, its audio source, when the session started and how many people listen in each language. Poll every 5 seconds or slower.","security":[{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"service_id":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c","live":true,"basis":"memory","source":"rtmp","session_id":"5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b","started_at":"2026-10-25T10:02:14.000Z","duration_seconds":1745,"listeners":{"total":38,"by_language":[{"code":"es-ES","count":31},{"code":"pt-BR","count":7}]},"as_of":"2026-10-25T10:31:19.000Z"},"schema":{"$ref":"#/components/schemas/ServiceStatus"}}}},"400":{"description":"Malformed parameters; details lists the issues","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, unknown, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such resource for this church","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded; see RateLimit-* and Retry-After headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/services/{id}/sessions":{"get":{"tags":["Sessions"],"summary":"Past sessions of a service","description":"Newest first. `billable_minutes` and `cost_usd` appear once a session has ended and its usage is computed (usually within minutes).","security":[{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c"},"required":true,"name":"id","in":"path"},{"schema":{"type":"integer","minimum":1,"default":1,"description":"1-based page number","example":1},"required":false,"description":"1-based page number","name":"page","in":"query"},{"schema":{"type":"integer","minimum":1,"default":20,"description":"Items per page, default 20, values above 50 are clamped","example":20},"required":false,"description":"Items per page, default 20, values above 50 are clamped","name":"limit","in":"query"},{"schema":{"type":"string","description":"ISO-8601, inclusive lower bound on started_at"},"required":false,"description":"ISO-8601, inclusive lower bound on started_at","name":"from","in":"query"},{"schema":{"type":"string","description":"ISO-8601, exclusive upper bound on started_at"},"required":false,"description":"ISO-8601, exclusive upper bound on started_at","name":"to","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":[{"id":"5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b","service_id":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c","service_title":"Sunday Service","started_at":"2026-10-25T10:02:14.000Z","ended_at":"2026-10-25T11:31:40.000Z","duration_seconds":5366,"status":"ended","speaker_language":"en-US","source":"rtmp","peak_listeners":41,"unique_listeners":57,"languages":["es-ES","pt-BR"],"billable_minutes":62,"cost_usd":5.17,"end_reason":null}],"page":1,"limit":20,"total":1},"schema":{"$ref":"#/components/schemas/SessionList"}}}},"400":{"description":"Malformed parameters; details lists the issues","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, unknown, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such resource for this church","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded; see RateLimit-* and Retry-After headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sessions/{id}":{"get":{"tags":["Sessions"],"summary":"One session with per-language minutes and listeners","description":"A past or live session: duration, listeners, billable minutes and, per language, the minutes translated and the people who listened.","security":[{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"id":"5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b","service_id":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c","service_title":"Sunday Service","started_at":"2026-10-25T10:02:14.000Z","ended_at":"2026-10-25T11:31:40.000Z","duration_seconds":5366,"status":"ended","speaker_language":"en-US","source":"rtmp","peak_listeners":41,"unique_listeners":57,"languages":["es-ES","pt-BR"],"billable_minutes":62,"cost_usd":5.17,"end_reason":null,"languages_detail":[{"code":"es-ES","minutes":62,"listeners":48},{"code":"pt-BR","minutes":40,"listeners":9}]},"schema":{"$ref":"#/components/schemas/SessionDetail"}}}},"400":{"description":"Malformed parameters; details lists the issues","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, unknown, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such resource for this church","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded; see RateLimit-* and Retry-After headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sessions/{id}/transcript":{"get":{"tags":["Sessions"],"summary":"Transcript as JSON, plain text or SubRip","description":"Every utterance with its translations. A language only has text for the minutes someone listened in it. `format=txt` and `format=srt` return text/plain.","security":[{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","description":"Return this translation (for example `es-ES`); omit for the original"},"required":false,"description":"Return this translation (for example `es-ES`); omit for the original","name":"language","in":"query"},{"schema":{"type":"string","enum":["json","txt","srt"],"default":"json"},"required":false,"name":"format","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"session_id":"5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b","lines":[{"at":"2026-10-25T10:02:19.000Z","original":"Good morning, everyone.","translations":{"es-ES":"Buenos días a todos.","pt-BR":"Bom dia a todos."}},{"at":"2026-10-25T10:02:24.500Z","original":"Please open your Bibles to Mark 4.","translations":{"es-ES":"Por favor abran sus Biblias en Marcos 4."}}],"truncated":false},"schema":{"$ref":"#/components/schemas/Transcript"}},"text/plain":{"schema":{"type":"string","example":"[10:00:05] Buenos días a todos\n"}}}},"400":{"description":"Malformed parameters; details lists the issues","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, unknown, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such resource for this church","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded; see RateLimit-* and Retry-After headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/usage":{"get":{"tags":["Usage"],"summary":"Billed minutes by day, language or service","description":"Minutes of spoken content that were transcribed or translated, with the pay-as-you-go cost (null on a subscription). Ranges up to 366 days. `group_by=service` is computed from the sessions in range and refuses ranges with more than 500 sessions.","security":[{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2026-10-01","description":"First day (inclusive), default: first day of the current month (UTC)"},"required":false,"description":"First day (inclusive), default: first day of the current month (UTC)","name":"from","in":"query"},{"schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","example":"2026-10-01","description":"Last day (inclusive), default: last day of the current month (UTC)"},"required":false,"description":"Last day (inclusive), default: last day of the current month (UTC)","name":"to","in":"query"},{"schema":{"type":"string","enum":["day","language","service"],"default":"day"},"required":false,"name":"group_by","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"from":"2026-10-01","to":"2026-10-31","group_by":"language","rows":[{"key":"es-ES","minutes":248,"cost_usd":20.67},{"key":"pt-BR","minutes":160,"cost_usd":13.33}],"totals":{"minutes":408,"cost_usd":34},"plan":null},"schema":{"$ref":"#/components/schemas/Usage"}}}},"400":{"description":"Malformed parameters; details lists the issues","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, unknown, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such resource for this church","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded; see RateLimit-* and Retry-After headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/recaps":{"get":{"tags":["Weekly recaps"],"summary":"Your weekly recaps, newest first","description":"One recap per service and language: title, big idea, quote, caption, scripture references, stats and the generated files. Ordered by service date.","security":[{"ApiKey":[]}],"parameters":[{"schema":{"type":"integer","minimum":1,"default":52},"required":false,"name":"limit","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":[{"id":"7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d","weekend":"2026-10-25","language":"en","title":"Hope in the Storm","big_idea":"God is present in trouble.","quote":"Peace, be still.","caption":"This Sunday we looked at Mark 4 and what it means to trust in the storm.","hashtags":["#faith","#hope"],"scripture_refs":["Mark 4:35-41"],"stats":{"listeners":42,"languages":3,"minutesLive":88,"phrasesTranslated":1240},"files":[{"key":"quote-square.jpg","url":"/v1/recaps/7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d/files/quote-square.jpg"},{"key":"study-guide.pdf","url":"/v1/recaps/7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d/files/study-guide.pdf"}],"email_sent_at":"2026-10-26T12:00:00.000Z","created_at":"2026-10-26T11:00:00.000Z"}]},"schema":{"$ref":"#/components/schemas/WeeklyRecapList"}}}},"400":{"description":"Malformed parameters; details lists the issues","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, unknown, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such resource for this church","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded; see RateLimit-* and Retry-After headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/recaps/{id}":{"get":{"tags":["Weekly recaps"],"summary":"One weekly recap","description":"One recap, with its files listed under `files`.","security":[{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c"},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"id":"7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d","weekend":"2026-10-25","language":"en","title":"Hope in the Storm","big_idea":"God is present in trouble.","quote":"Peace, be still.","caption":"This Sunday we looked at Mark 4 and what it means to trust in the storm.","hashtags":["#faith","#hope"],"scripture_refs":["Mark 4:35-41"],"stats":{"listeners":42,"languages":3,"minutesLive":88,"phrasesTranslated":1240},"files":[{"key":"quote-square.jpg","url":"/v1/recaps/7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d/files/quote-square.jpg"},{"key":"study-guide.pdf","url":"/v1/recaps/7a8b9c0d-1e2f-4a3b-8c4d-5e6f7a8b9c0d/files/study-guide.pdf"}],"email_sent_at":"2026-10-26T12:00:00.000Z","created_at":"2026-10-26T11:00:00.000Z"},"schema":{"$ref":"#/components/schemas/WeeklyRecap"}}}},"400":{"description":"Malformed parameters; details lists the issues","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, unknown, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such resource for this church","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded; see RateLimit-* and Retry-After headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/recaps/{id}/files/{key}":{"get":{"tags":["Weekly recaps"],"summary":"Signed download link for one recap file","description":"Returns a URL valid for 600 seconds. Add `?redirect=1` to be redirected to the file instead.","security":[{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","enum":["quote-square.jpg","quote-story.jpg","verse-square.jpg","study-guide.pdf","kids-page.pdf"]},"required":true,"name":"key","in":"path"},{"schema":{"type":"string"},"required":false,"name":"redirect","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"url":"https://vttdolfrieslmlgzlwty.supabase.co/storage/v1/object/sign/weekly-recaps/…","expires_in":600},"schema":{"$ref":"#/components/schemas/RecapFileUrl"}}}},"302":{"description":"Redirect to the signed URL (with ?redirect=1)"},"400":{"description":"Malformed parameters; details lists the issues","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, unknown, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such resource for this church","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded; see RateLimit-* and Retry-After headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/services/{id}/stream-key":{"get":{"tags":["Services"],"summary":"RTMP ingest URL and stream key","description":"For hands-free sessions: point an RTMP encoder at `rtmp_url` with `stream_key`. Requires the `stream_keys:read` scope.","security":[{"ApiKey":[]}],"parameters":[{"schema":{"type":"string","format":"uuid","example":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c"},"required":true,"name":"id","in":"path"},{"schema":{"type":"string","description":"Speech language for the key (for example `es-ES` or `multi`); defaults to the service speaker language"},"required":false,"description":"Speech language for the key (for example `es-ES` or `multi`); defaults to the service speaker language","name":"language","in":"query"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"rtmp_url":"rtmp://stream.glossa.live:1935/live","stream_key":"glossa_M2YyYjdjMWUtOWQ0YS00YjhlLWExYzItMGQ1ZTZmN2E4YjljOmVuLVVTOmV4YW1wbGVzZWNyZXQ","language":"en-US"},"schema":{"$ref":"#/components/schemas/StreamKey"}}}},"400":{"description":"Malformed parameters; details lists the issues","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Missing, unknown, revoked or expired API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"The key lacks the required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such resource for this church","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded; see RateLimit-* and Retry-After headers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"webhooks":{"session.started":{"post":{"tags":["Webhooks"],"summary":"A session started","description":"Sent right after a session begins on one of your services, with the listeners already connected. Signed with `Glossa-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256(secret, \"<t>.<raw body>\")>`.","requestBody":{"content":{"application/json":{"example":{"id":"9b1c2d3e-4f5a-4b6c-8d7e-0f1a2b3c4d5e","type":"session.started","created_at":"2026-10-25T10:02:14.000Z","api_version":"1","data":{"service":{"id":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c","title":"Sunday Service"},"session":{"id":"5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b","started_at":"2026-10-25T10:02:14.000Z","source":"rtmp","speaker_language":"en-US"},"listeners":{"total":3,"by_language":[{"code":"es-ES","count":3}]}}},"schema":{"$ref":"#/components/schemas/WebhookEvent_session_started"}}}},"responses":{"200":{"description":"Return any 2xx status to acknowledge the event. Anything else (or no answer within 10 s) is retried: 5 attempts over about 80 minutes."}}}},"session.ended":{"post":{"tags":["Webhooks"],"summary":"A session ended","description":"Sent when the session stops, with its duration, peak and unique listeners. Billable minutes follow in session.usage_ready. Signed with `Glossa-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256(secret, \"<t>.<raw body>\")>`.","requestBody":{"content":{"application/json":{"example":{"id":"9b1c2d3e-4f5a-4b6c-8d7e-0f1a2b3c4d5e","type":"session.ended","created_at":"2026-10-25T10:02:14.000Z","api_version":"1","data":{"service":{"id":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c","title":"Sunday Service"},"session":{"id":"5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b","started_at":"2026-10-25T10:02:14.000Z","ended_at":"2026-10-25T11:31:40.000Z","duration_seconds":5366,"source":"rtmp","speaker_language":"en-US","peak_listeners":41,"unique_listeners":57,"end_reason":null}}},"schema":{"$ref":"#/components/schemas/WebhookEvent_session_ended"}}}},"responses":{"200":{"description":"Return any 2xx status to acknowledge the event. Anything else (or no answer within 10 s) is retried: 5 attempts over about 80 minutes."}}}},"session.usage_ready":{"post":{"tags":["Webhooks"],"summary":"Usage for a session is computed","description":"Sent a few minutes after the end, once billable minutes, cost and the per-language breakdown are known. Signed with `Glossa-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256(secret, \"<t>.<raw body>\")>`.","requestBody":{"content":{"application/json":{"example":{"id":"9b1c2d3e-4f5a-4b6c-8d7e-0f1a2b3c4d5e","type":"session.usage_ready","created_at":"2026-10-25T10:02:14.000Z","api_version":"1","data":{"service":{"id":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c","title":"Sunday Service"},"session":{"id":"5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b","started_at":"2026-10-25T10:02:14.000Z","ended_at":"2026-10-25T11:31:40.000Z","duration_seconds":5366},"usage":{"billable_minutes":62,"cost_usd":5.17,"languages":[{"code":"es-ES","minutes":62,"listeners":48},{"code":"pt-BR","minutes":40,"listeners":9}]}}},"schema":{"$ref":"#/components/schemas/WebhookEvent_session_usage_ready"}}}},"responses":{"200":{"description":"Return any 2xx status to acknowledge the event. Anything else (or no answer within 10 s) is retried: 5 attempts over about 80 minutes."}}}},"listener.joined":{"post":{"tags":["Webhooks"],"summary":"A listener connected","description":"One event per listener (anonymous id), with the listener counts per language after the join. At most 600 listener events per minute per church. Signed with `Glossa-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256(secret, \"<t>.<raw body>\")>`.","requestBody":{"content":{"application/json":{"example":{"id":"9b1c2d3e-4f5a-4b6c-8d7e-0f1a2b3c4d5e","type":"listener.joined","created_at":"2026-10-25T10:02:14.000Z","api_version":"1","data":{"service":{"id":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c","title":"Sunday Service"},"session":{"id":"5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b"},"listener":{"id":"c9b4f1e2-7a3d-4c58-9e21-0f6b8d7a5c31","language":"es-ES","joined_at":"2026-10-25T10:05:03.000Z"},"listeners":{"total":38,"by_language":[{"code":"es-ES","count":31},{"code":"pt-BR","count":7}]}}},"schema":{"$ref":"#/components/schemas/WebhookEvent_listener_joined"}}}},"responses":{"200":{"description":"Return any 2xx status to acknowledge the event. Anything else (or no answer within 10 s) is retried: 5 attempts over about 80 minutes."}}}},"listener.left":{"post":{"tags":["Webhooks"],"summary":"A listener left","description":"One event per listener, with the time listened and the counts after the leave. A language switch is a leave followed by a join with a new id. Signed with `Glossa-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256(secret, \"<t>.<raw body>\")>`.","requestBody":{"content":{"application/json":{"example":{"id":"9b1c2d3e-4f5a-4b6c-8d7e-0f1a2b3c4d5e","type":"listener.left","created_at":"2026-10-25T10:02:14.000Z","api_version":"1","data":{"service":{"id":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c","title":"Sunday Service"},"session":{"id":"5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b"},"listener":{"id":"c9b4f1e2-7a3d-4c58-9e21-0f6b8d7a5c31","language":"es-ES","joined_at":"2026-10-25T10:05:03.000Z","left_at":"2026-10-25T11:30:12.000Z","duration_seconds":5109},"listeners":{"total":37,"by_language":[{"code":"es-ES","count":30},{"code":"pt-BR","count":7}]}}},"schema":{"$ref":"#/components/schemas/WebhookEvent_listener_left"}}}},"responses":{"200":{"description":"Return any 2xx status to acknowledge the event. Anything else (or no answer within 10 s) is retried: 5 attempts over about 80 minutes."}}}},"translation.utterance":{"post":{"tags":["Webhooks"],"summary":"A sentence was translated","description":"One event per utterance with every language the endpoint asked for. Migrated per-service webhooks receive the legacy body instead (see the docs). Signed with `Glossa-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256(secret, \"<t>.<raw body>\")>`.","requestBody":{"content":{"application/json":{"example":{"id":"9b1c2d3e-4f5a-4b6c-8d7e-0f1a2b3c4d5e","type":"translation.utterance","created_at":"2026-10-25T10:02:14.000Z","api_version":"1","data":{"service":{"id":"3f2b7c1e-9d4a-4b8e-a1c2-0d5e6f7a8b9c"},"session":{"id":"5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b"},"sequence":12,"text":"Please open your Bibles to Mark 4.","translations":{"es-ES":"Por favor abran sus Biblias en Marcos 4.","pt-BR":"Por favor abram suas Bíblias em Marcos 4."}}},"schema":{"$ref":"#/components/schemas/WebhookEvent_translation_utterance"}}}},"responses":{"200":{"description":"Return any 2xx status to acknowledge the event. Anything else (or no answer within 10 s) is retried: 5 attempts over about 80 minutes."}}}},"webhook.test":{"post":{"tags":["Webhooks"],"summary":"A test event","description":"Sent from Settings → Webhooks or POST /api/account/webhooks/{id}/test; carries no service. Signed with `Glossa-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256(secret, \"<t>.<raw body>\")>`.","requestBody":{"content":{"application/json":{"example":{"id":"9b1c2d3e-4f5a-4b6c-8d7e-0f1a2b3c4d5e","type":"webhook.test","created_at":"2026-10-25T10:02:14.000Z","api_version":"1","data":{"service":null,"message":"This is a test from Glossa"}},"schema":{"$ref":"#/components/schemas/WebhookEvent_webhook_test"}}}},"responses":{"200":{"description":"Return any 2xx status to acknowledge the event. Anything else (or no answer within 10 s) is retried: 5 attempts over about 80 minutes."}}}}}}