Streaming

Download schema

Note: the Start streaming endpoint can only be used to start streaming from a Kaleo Connect device. This endpoint cannot be used to start streaming from a web browser. All other streaming endpoints control both browser and Kaleo Connect devices.

Get streaming status

GET

https://babel.withkaleo.com

/v1/church/{churchId}/streaming

Bearer (API key)

Read the current session and shared church settings. All fields are present, including while idle.

Get streaming status › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Get streaming status › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

Start streaming

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/start

Bearer (API key)

Start streaming on a Kaleo Connect device using saved settings. The optional body can select a deviceId and override settings for this session. Without deviceId, Kaleo picks the default audio source configured on the Kaleo Connect page (under Integrations) in your dashboard if there are multiple audio-capable devices available, or the only available audio source device if just one is available.

Start streaming › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Start streaming › Request Body optional

StartStreaming

deviceId

string

Optional audio source device ID from GET /devices. Overrides the church default for this session. If omitted, use the saved default audio source or the sole audio-source-capable paired device; multiple devices without a default require selection. The selected device must still be ready.

object

Settings for this session only. Omitted fields use saved defaults.

Start streaming › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

POST/v1/church/{churchId}/streaming/start

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/start \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{}'

Example Request Body

{}

json

application/json

Example Responses

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Stop streaming

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/stop

Bearer (API key)

Stop the current streaming session. No request body is needed.

Stop streaming › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Stop streaming › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

Change translation voice

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/voice

Bearer (API key)

Change the translation voice while idle or streaming.

Change translation voice › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Change translation voice › Request Body

ChangeVoice

voice

string · enum · required

Translation voice. Can change while idle or streaming.

Enum values:

male

female

Change translation voice › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

PATCH/v1/church/{churchId}/streaming/voice

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/voice \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "voice": "female"
}'

Example Request Body

{
  "voice": "female"
}

json

application/json

Example Responses

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "female",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Change visibility

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/visibility

Bearer (API key)

Show or hide captions while idle or streaming. Hiding captions does not stop the session.

Change visibility › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Change visibility › Request Body

ChangeVisibility

visible

boolean · required

true shows captions; false hides them while streaming continues.

Change visibility › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

PATCH/v1/church/{churchId}/streaming/visibility

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/visibility \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "visible": false
}'

Example Request Body

{
  "visible": false
}

json

application/json

Example Responses

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": false,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Clear captions

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/captions/clear

Bearer (API key)

Clear the current caption feed. No request body is needed.

Clear captions › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Clear captions › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

POST/v1/church/{churchId}/streaming/captions/clear

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/captions/clear \
  --request POST \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Change auto-stop deadline

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline

Bearer (API key)

Set the auto-stop time for an active session. Returns the updated streaming status.

Change auto-stop deadline › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Change auto-stop deadline › Request Body

ChangeDeadline

deadlineAt

string · date-time · required

Future auto-stop time with Z or a timezone offset. No later than six hours after startedAt.

Change auto-stop deadline › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

PATCH/v1/church/{churchId}/streaming/deadline

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deadlineAt": "2026-10-08T16:00:00Z"
}'

Example Request Body

{
  "deadlineAt": "2026-10-08T16:00:00Z"
}

json

application/json

Example Responses

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Adjust auto-stop time

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline/adjust

Bearer (API key)

Add or subtract auto-stop time. While idle, change the duration for the next manual start. While streaming, change the current deadline. Each request applies a separate adjustment.

Adjust auto-stop time › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Adjust auto-stop time › Request Body

AdjustDeadline

deltaSeconds

integer · min: -21600 · max: 21600 · required

Seconds to add to the idle duration or current deadline; negative values subtract. Cannot be 0. Idle duration: 60–21600 seconds. Live deadline: future, within six hours of startedAt.

Adjust auto-stop time › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

POST/v1/church/{churchId}/streaming/deadline/adjust

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline/adjust \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deltaSeconds": 120
}'

Example Request Body

{
  "deltaSeconds": 120
}

json

application/json

Example Responses

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Devices Sessions

Kaleo API

Streaming

Download schema

Get streaming status

GET

https://babel.withkaleo.com

/v1/church/{churchId}/streaming

Bearer (API key)

Read the current session and shared church settings. All fields are present, including while idle.

Get streaming status › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Get streaming status › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

Start streaming

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/start

Bearer (API key)

Start streaming › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Start streaming › Request Body optional

StartStreaming

deviceId

string

object

Settings for this session only. Omitted fields use saved defaults.

Start streaming › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

POST/v1/church/{churchId}/streaming/start

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/start \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{}'

Example Request Body

{}

json

application/json

Example Responses

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Stop streaming

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/stop

Bearer (API key)

Stop the current streaming session. No request body is needed.

Stop streaming › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Stop streaming › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

Change translation voice

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/voice

Bearer (API key)

Change the translation voice while idle or streaming.

Change translation voice › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Change translation voice › Request Body

ChangeVoice

voice

string · enum · required

Translation voice. Can change while idle or streaming.

Enum values:

male

female

Change translation voice › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

PATCH/v1/church/{churchId}/streaming/voice

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/voice \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "voice": "female"
}'

Example Request Body

{
  "voice": "female"
}

json

application/json

Example Responses

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "female",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Change visibility

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/visibility

Bearer (API key)

Show or hide captions while idle or streaming. Hiding captions does not stop the session.

Change visibility › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Change visibility › Request Body

ChangeVisibility

visible

boolean · required

true shows captions; false hides them while streaming continues.

Change visibility › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

PATCH/v1/church/{churchId}/streaming/visibility

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/visibility \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "visible": false
}'

Example Request Body

{
  "visible": false
}

json

application/json

Example Responses

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": false,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Clear captions

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/captions/clear

Bearer (API key)

Clear the current caption feed. No request body is needed.

Clear captions › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Clear captions › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

POST/v1/church/{churchId}/streaming/captions/clear

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/captions/clear \
  --request POST \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Change auto-stop deadline

PATCH

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline

Bearer (API key)

Set the auto-stop time for an active session. Returns the updated streaming status.

Change auto-stop deadline › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Change auto-stop deadline › Request Body

ChangeDeadline

deadlineAt

string · date-time · required

Future auto-stop time with Z or a timezone offset. No later than six hours after startedAt.

Change auto-stop deadline › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

PATCH/v1/church/{churchId}/streaming/deadline

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline \
  --request PATCH \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deadlineAt": "2026-10-08T16:00:00Z"
}'

Example Request Body

{
  "deadlineAt": "2026-10-08T16:00:00Z"
}

json

application/json

Example Responses

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Adjust auto-stop time

POST

https://babel.withkaleo.com

/v1/church/{churchId}/streaming/deadline/adjust

Bearer (API key)

Add or subtract auto-stop time. While idle, change the duration for the next manual start. While streaming, change the current deadline. Each request applies a separate adjustment.

Adjust auto-stop time › Path Parameters

churchId

string · required

Your church ID. Copy it from the API page (under Integrations) in your dashboard.

Adjust auto-stop time › Request Body

AdjustDeadline

deltaSeconds

integer · min: -21600 · max: 21600 · required

Seconds to add to the idle duration or current deadline; negative values subtract. Cannot be 0. Idle duration: 60–21600 seconds. Live deadline: future, within six hours of startedAt.

Adjust auto-stop time › Responses

Success

Current session and shared church settings. All fields are present, including while idle.

StreamingStatus

streaming

boolean · required

true during an active session, including startup, reconnects, and shutdown. Does not confirm audio is arriving.

sessionId

string | null · required

Current session ID; null while idle.

startedAt

string | null · date-time · required

Current session start time; null while idle.

deadlineAt

string | null · date-time · required

Automatic stop time; null while idle or if no deadline is recorded.

speakerLanguage

string | null · required

Current speaker language code; null while idle.

targetLanguages

string[] · required

Current translation language codes; empty while idle.

voice

string · enum · required

Translation voice, including while idle.

Enum values:

male

female

visible

boolean · required

true shows captions; false hides them. Also applies while idle.

publisher

object | null · required

Kaleo Connect device or browser that sends audio; null while idle.

phase

string · enum · required

Session stage; idle means no session is active.

Enum values:

idle

starting

streaming

reconnecting

ending

object · required

Church defaults for the next manual start. Active session overrides do not change these values.

POST/v1/church/{churchId}/streaming/deadline/adjust

curl https://babel.withkaleo.com/v1/church/:churchId/streaming/deadline/adjust \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "deltaSeconds": 120
}'

Example Request Body

{
  "deltaSeconds": 120
}

json

application/json

Example Responses

{
  "streaming": true,
  "sessionId": "00000000-0000-4000-8000-000000000001",
  "startedAt": "2026-10-08T14:00:00.000Z",
  "deadlineAt": "2026-10-08T16:00:00.000Z",
  "speakerLanguage": "en",
  "targetLanguages": [
    "fr-FR"
  ],
  "voice": "male",
  "visible": true,
  "publisher": {
    "kind": "connect",
    "id": "00000000-0000-4000-8000-000000000002",
    "name": "Sanctuary Mac"
  },
  "phase": "streaming",
  "streamSettings": {
    "revision": 4,
    "settings": {
      "speakerLanguage": "en",
      "targetLanguages": [
        "fr-FR"
      ],
      "duration": 3600
    }
  }
}

json

application/json

Devices Sessions