> 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. # Move a Live to another organization PUT https://api.bibleit.app/v1/lives/{live_id}/workspace Content-Type: application/json **Required scopes:** `live.move`. Requires the source Authorization bearer with live.move and a destination X-Destination-Service-Token with live.create. Both credentials are revalidated after acquiring sorted workspace locks. Destination mismatch, expiry/revocation or missing destination credential returns 403. Destination total Live quota applies; exhausted capacity or same-workspace requests return 409. Missing/foreign source Lives return 404. Only organization-to-organization moves are supported. Ownership and cleared payloads commit in one transaction before disconnecting viewers and management watchers. Clears scripture payload/reference and presentation snapshots/media pins, resets to hidden Reader mode with pause off, removes collaborators and revokes pending Live invitations. Replaces translation selections and viewer limit with destination library/quota. Existing audience secrets are invalidated while preserving protection. Name, lifecycle status, runtime and viewer styling remain. Returns destination-owned Live and new ETag; source-only credentials lose access. On an ambiguous timeout, inspect through the destination token before retrying. A retry using the old source organization returns 404 once moved. **Response headers:** - `ETag` (200): Shared Live sequence validator. Any relevant metadata, display, playback or workspace change invalidates it. Reference: https://docs.bibleit.dev/api-reference/organizations/organization-lives/move-live-workspace ## 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. - `X-Destination-Service-Token` header (required) — Destination organization svc_ secret. Must belong to organization_id in the move body and hold live.create. Required in addition to source Authorization bearer; never put this secret in a URL or body. ## Request ### Path parameters - `live_id` (string, required) ### Headers - `If-Match` (string, required) — Shared Live sequence validator. Any relevant metadata, display, playback or workspace change invalidates it. Missing:428; stale:412; malformed, weak, wildcard or list:422. ### Body (application/json) This endpoint expects a LiveWorkspacePut. - `organization_id` (string, required) — Immutable destination organization UUID. Personal workspaces and handles are not accepted. ## Response ### 200 Successful operation - `id` (string, required) - `organization_id` (string, required) - `name` (string, required) - `status` (enum, required) - Allowed values: `running`, `stopped` - `mode` (enum, required) - Allowed values: `reader`, `presentation` - `paused` (boolean, required) - `sequence` (integer, 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) ## Examples **Request** ```json { "organization_id": "00000000-0000-4000-8000-000000000002" } ``` **Response** ```json { "id": "sample-live", "organization_id": "00000000-0000-4000-8000-000000000001", "name": "Sunday Service", "status": "stopped", "mode": "reader", "paused": false, "sequence": 0 } ``` **SDK Code** ```python import requests url = "https://api.bibleit.app/v1/lives/live_id/workspace" payload = { "organization_id": "00000000-0000-4000-8000-000000000002" } headers = { "If-Match": "If-Match", "Authorization": "Bearer ", "Content-Type": "application/json" } response = requests.put(url, json=payload, headers=headers) print(response.json()) ``` ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://api.bibleit.app/v1/lives/live_id/workspace" payload := strings.NewReader("{\n \"organization_id\": \"00000000-0000-4000-8000-000000000002\"\n}") req, _ := http.NewRequest("PUT", url, payload) req.Header.Add("If-Match", "If-Match") req.Header.Add("Authorization", "Bearer ") req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ```