> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bibleit.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bibleit.dev/_mcp/server.

# Read organization Live Studio settings

GET https://api.bibleit.app/v1/organizations/{organization_id}/live-studio

**Required scopes:** `live_studio.get`.

Service-token organization UUID boundary applies; handles and foreign organization IDs return 404. Personal tokens and browser sessions are not accepted. Only organization_id, revision and normalized settings are returned; editor attribution and internal token principals are omitted. Returns saved settings or effective defaults at revision 0 without creating a settings row. Rechecks current explicit scope after acquiring a shared workspace lock. Studio configuration reads remain available during processing restriction.

**Response headers:**

- `ETag` (200): Strong validator covering the effective settings and revision. Separate from Live playback/display sequence validators. Use unchanged as If-Match on PUT.

Reference: https://docs.bibleit.dev/api-reference/organizations/live-studio/get-organization-live-studio

## Authentication

- `Authorization` header (bearer token, required) — Organization-owned service token. Issue the initial token in organization credential settings. Scopes are documented per operation via x-required-scopes; they are not OAuth scopes.

## Request

### Path parameters

- `organization_id` (string, required) — Immutable organization UUID bound to the service token.

## Response

### 200

Current organization Live Studio settings

- `organization_id` (string, required)
- `revision` (integer, required) — Settings revision independent of any Live sequence. Zero represents unsaved defaults; every accepted PUT increments the revision, even for identical settings.
- `settings` (LiveStudioSettings, required)

## Errors

### 401 Unauthorized Error

Error response. 400 malformed JSON; 401 invalid/expired/revoked token; 403 denied scope or domain policy; 404 unknown/foreign resource; 405 unsupported method; 409 quota/conflict or stopped Live; 412 stale state validator; 428 missing If-Match; 413 body too large; 415 unsupported media type; 422 invalid fields; 429 admission budget exhausted; 503 unavailable dependency.

- `type` (any, required)
- `title` (string, required)
- `status` (integer, required)
- `code` (string, required)
- `request_id` (string, required)

### 403 Forbidden Error

Error response. 400 malformed JSON; 401 invalid/expired/revoked token; 403 denied scope or domain policy; 404 unknown/foreign resource; 405 unsupported method; 409 quota/conflict or stopped Live; 412 stale state validator; 428 missing If-Match; 413 body too large; 415 unsupported media type; 422 invalid fields; 429 admission budget exhausted; 503 unavailable dependency.

- `type` (any, required)
- `title` (string, required)
- `status` (integer, required)
- `code` (string, required)
- `request_id` (string, required)

### 404 Not Found Error

Error response. 400 malformed JSON; 401 invalid/expired/revoked token; 403 denied scope or domain policy; 404 unknown/foreign resource; 405 unsupported method; 409 quota/conflict or stopped Live; 412 stale state validator; 428 missing If-Match; 413 body too large; 415 unsupported media type; 422 invalid fields; 429 admission budget exhausted; 503 unavailable dependency.

- `type` (any, required)
- `title` (string, required)
- `status` (integer, required)
- `code` (string, required)
- `request_id` (string, required)

### 429 Too Many Requests Error

Error response. 400 malformed JSON; 401 invalid/expired/revoked token; 403 denied scope or domain policy; 404 unknown/foreign resource; 405 unsupported method; 409 quota/conflict or stopped Live; 412 stale state validator; 428 missing If-Match; 413 body too large; 415 unsupported media type; 422 invalid fields; 429 admission budget exhausted; 503 unavailable dependency.

- `type` (any, required)
- `title` (string, required)
- `status` (integer, required)
- `code` (string, required)
- `request_id` (string, required)

### 503 Service Unavailable Error

Error response. 400 malformed JSON; 401 invalid/expired/revoked token; 403 denied scope or domain policy; 404 unknown/foreign resource; 405 unsupported method; 409 quota/conflict or stopped Live; 412 stale state validator; 428 missing If-Match; 413 body too large; 415 unsupported media type; 422 invalid fields; 429 admission budget exhausted; 503 unavailable dependency.

- `type` (any, required)
- `title` (string, required)
- `status` (integer, required)
- `code` (string, required)
- `request_id` (string, required)

## Types

### LiveStudioSettings

- `version` (enum, required)
  - Allowed values: `1`
- `showLogo` (boolean, required)
- `preset` (enum, required, default: default)
  - Allowed values: `default`, `midnight`, `paper`, `ocean`
- `transition` (enum, required, default: none)
  - Allowed values: `none`, `fade`, `slide`, `slide_up`, `slide_down`, `zoom_in`, `zoom_out`, `wipe`
- `controls` (LiveStudioSettingsControls, required)
- `palettes` (LiveStudioSettingsPalettes, required)
- `container` (LiveStudioSettingsContainer, required)
- `elements` (LiveStudioSettingsElements, required)
- `order` (list of enum, required)
  - Allowed values: `translation`, `reference`, `text`

### LiveStudioSettingsControls

- `theme` (boolean, required)
- `fullscreen` (boolean, required)
- `fontSize` (boolean, required)

### LiveStudioSettingsPalettes

- `dark` (LiveStudioSettingsPalettesDark, required)
- `light` (LiveStudioSettingsPalettesLight, required)

### LiveStudioSettingsContainer

- `radius` (integer, required, nullable)
- `padding` (integer, required, nullable)
- `border` (string, required, nullable) — Six-digit hexadecimal color; null inherits the selected preset.

### LiveStudioSettingsElements

- `translation` (LiveStudioSettingsElementsTranslation, required)
- `reference` (LiveStudioSettingsElementsReference, required)
- `text` (LiveStudioSettingsElementsText, required)

### LiveStudioSettingsPalettesDark

- `background` (string, required, nullable) — Six-digit hexadecimal color; null inherits the selected preset.
- `container` (string, required, nullable) — Six-digit hexadecimal color; null inherits the selected preset.
- `translation` (string, required, nullable) — Six-digit hexadecimal color; null inherits the selected preset.
- `reference` (string, required, nullable) — Six-digit hexadecimal color; null inherits the selected preset.
- `text` (string, required, nullable) — Six-digit hexadecimal color; null inherits the selected preset.

### LiveStudioSettingsPalettesLight

- `background` (string, required, nullable) — Six-digit hexadecimal color; null inherits the selected preset.
- `container` (string, required, nullable) — Six-digit hexadecimal color; null inherits the selected preset.
- `translation` (string, required, nullable) — Six-digit hexadecimal color; null inherits the selected preset.
- `reference` (string, required, nullable) — Six-digit hexadecimal color; null inherits the selected preset.
- `text` (string, required, nullable) — Six-digit hexadecimal color; null inherits the selected preset.

### LiveStudioSettingsElementsTranslation

- `font` (enum, required)
  - Allowed values: `serif`, `sans`, `mono`
- `size` (integer, required)
- `bold` (boolean, required)
- `italic` (boolean, required)
- `align` (enum, required)
  - Allowed values: `left`, `center`, `right`
- `lineHeight` (integer, required)

### LiveStudioSettingsElementsReference

- `font` (enum, required)
  - Allowed values: `serif`, `sans`, `mono`
- `size` (integer, required)
- `bold` (boolean, required)
- `italic` (boolean, required)
- `align` (enum, required)
  - Allowed values: `left`, `center`, `right`
- `lineHeight` (integer, required)

### LiveStudioSettingsElementsText

- `font` (enum, required)
  - Allowed values: `serif`, `sans`, `mono`
- `size` (integer, required)
- `bold` (boolean, required)
- `italic` (boolean, required)
- `align` (enum, required)
  - Allowed values: `left`, `center`, `right`
- `lineHeight` (integer, required)

## Examples

**Response**

```json
{
  "organization_id": "string",
  "revision": 1,
  "settings": {
    "version": 1,
    "showLogo": true,
    "preset": "default",
    "transition": "none",
    "controls": {
      "theme": true,
      "fullscreen": true,
      "fontSize": true
    },
    "palettes": {
      "dark": {
        "background": null,
        "container": null,
        "translation": null,
        "reference": null,
        "text": null
      },
      "light": {
        "background": null,
        "container": null,
        "translation": null,
        "reference": null,
        "text": null
      }
    },
    "container": {
      "radius": null,
      "padding": null,
      "border": null
    },
    "elements": {
      "translation": {
        "font": "sans",
        "size": 100,
        "bold": true,
        "italic": false,
        "align": "left",
        "lineHeight": 112
      },
      "reference": {
        "font": "sans",
        "size": 100,
        "bold": true,
        "italic": false,
        "align": "left",
        "lineHeight": 112
      },
      "text": {
        "font": "serif",
        "size": 100,
        "bold": false,
        "italic": false,
        "align": "left",
        "lineHeight": 112
      }
    },
    "order": [
      "translation",
      "reference",
      "text"
    ]
  }
}
```

**SDK Code**

```python
import requests

url = "https://api.bibleit.app/v1/organizations/organization_id/live-studio"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bibleit.app/v1/organizations/organization_id/live-studio"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```