> ## Documentation Index > Fetch the complete documentation index at: https://docs.praxis-ai.com/llms.txt > Use this file to discover all available pages before exploring further. # Edit one scene's narration or on-screen text > Small direct text edit by the owner: the scene's `narration`, or one on-screen text field of its component, named by its path below `props` (title `kicker|title|subtitle`; statement `kicker|text|emphasis`; bullets `title`, `items//text`; metric `label|caption`; bar-chart `title|caption`, `bars//label`; flow `title`, `steps//label|detail`; quote `quote|attribution|role` only when the quote has no source; cta `title|subtitle`) — only fields the scene already has. A statement's emphasis must stay part of its text. Numbers, number prefixes/suffixes/units, the cta address, claim references, component, layout and background are not editable here. The text is trimmed and capped by the document schema (narration 600 characters; on-screen text 24–200 depending on the field). The edit is validated like the Digital Twin's own saves: a number that no claim of the scene backs, a link or e-mail address, an address spelled out in narration or more than 50 narration words is refused (422 with the validator's `errors`). An accepted edit creates a new version; the narration is re-made in the background (only an edited scene is voiced again and charged), and the Digital Twin's face is recorded again only when the narration changed. An export estimate for the previous version is stale afterwards. `revision` (the version you edited) is required. A narration edit is refused up front when the video would clearly leave its length (55–65 s for a 1-minute video, 170–190 s for a 3-minute one; 422 NARRATION_TIMING with the projected total and the word range that fits). Not while the Digital Twin is still building the video (409 BUILD_IN_PROGRESS). Fields you edited are listed on later versions as `ownerEdited` until the Digital Twin rewrites them. Owner only; 30 edits per minute. ## OpenAPI ````yaml /mdx/api-reference/runtime/runtime-api.json patch /api/user/presentations/{id}/scenes/{sceneId} openapi: 3.0.0 info: title: Pria Runtime API version: 2.0.236 description: >- Pria API Documentation Praxis's developer platform is a core part of our mission to empower organizations to grow better. Our APIs are designed to enable teams of any shape or size to build robust integrations that help them customize and get the most value out of Pria. All Pria APIs are built using REST conventions and designed to have a predictable URL structure.

They use many standard HTTP features, including methods (POST, GET, PUT, DELETE) and error response codes.

All API calls are made under https://hiimpria.ai/api and all responses return standard JSON. In these docs, you'll find lists of all available endpoints for a given API, along with interactive code blocks for building requests. For walkthroughs of basic usage for these APIs, check out the API guides.

A session that a course page (Canvas) opened for an administrator — or that a Digital Twin's sign-in provider opened for one of its people — starts with user rights in that twin only: until the person confirms it's them with a code (POST /api/user/launch-scope/challenge, then /api/auth/mfa-resend and /api/auth/mfa-verify), every route outside that twin's day-to-day work answers 403 with code LAUNCH_SCOPE_STEP_UP and the twin's id. servers: - url: https://pria.praxislxp.com description: Pria API Server security: [] tags: - name: Authentication description: User authentication, registration, and password management (/api/auth) - name: OAuth description: OAuth authentication providers - Google, GitHub, SSO (/api/auth/oauth) - name: User description: User profile management and account operations (/api/user) - name: User Institutions description: User institution memberships and switching (/api/user/institution) - name: User Tools description: Available tools for authenticated users (/api/user/tools) - name: Institutions description: Institution settings and configuration (/api/user/institution) - name: Conversation description: AI conversation and Q&A endpoints (/api/ai) - name: Realtime description: Real-time voice AI and WebRTC sessions (/api/ai/rt) - name: Assistant description: AI assistant configuration and management (/api/user/assistant) - name: History description: Conversation history and favorites (/api/user/history) - name: RAG description: >- Document upload, embedding, and retrieval-augmented generation (/api/user/files, /api/user/rag) - name: Setting description: Instance variables and settings management (/api/user/setting) - name: Branding description: Digital twin branding and customization (/api/agent/branding) - name: Agent description: Agent engagement and session management (/api/agent) - name: SDK Launch description: >- SDK launch token signing and verification for secure iframe embedding (/api/auth/sdk-sign, /api/auth/sdk-verify) - name: Testing description: Health checks, diagnostics, and test endpoints (/api/test) - name: Admin Accounts description: Account management for super admins (/api/admin/account) - name: Admin Institutions description: Institution management for admins (/api/admin/institution) - name: Admin Users description: User management for admins (/api/admin/user) - name: Admin Entitlements description: >- User-institution relationships and permissions (/api/admin/userInstitution) - name: Admin Sessions description: Session management for admins (/api/admin/session) - name: Admin Histories description: Conversation history management and analytics (/api/admin/history) - name: Admin Assistants description: AI assistant management for admins (/api/admin/assistant) - name: Admin Questions description: Institution question and prompt management (/api/admin/question) - name: Admin Tools description: Tool configuration management (/api/admin/tool) - name: Admin AI Models description: AI model configuration (/api/admin/aimodel) - name: Admin MCP Servers description: Model Context Protocol server management (/api/admin/mcpserver) - name: Admin Feedbacks description: User feedback management (/api/admin/feedback) - name: Admin Uploads description: Upload management (/api/admin/upload) - name: Admin Charts description: Analytics and visualization chart management (/api/admin/chart) - name: Audio Notes description: Capture and ingest spoken notes into the personal vault - name: Memory description: User-facing memory parameters (personal + shared instance memory). - name: My Data description: >- GDPR controls — personal-scope counts, async ZIP-by-email export, and scoped soft-delete. Every endpoint pins `user = req.user._id` AND `institution: null`; institution-scoped data is governed by the institution's own retention policy and never reached from here. - name: Questions description: >- User-facing read of the onboarding question bank used by the "create a digital twin" wizard. - name: Transcription description: >- One-shot speech-to-text for in-place dictation. Audio blob in, transcript out — no Upload / History / RAG embeddings are persisted. Use `/audio-notes` for anything durable. paths: /api/user/presentations/{id}/scenes/{sceneId}: patch: tags: - Presentations summary: Edit one scene's narration or on-screen text description: > Small direct text edit by the owner: the scene's `narration`, or one on-screen text field of its component, named by its path below `props` (title `kicker|title|subtitle`; statement `kicker|text|emphasis`; bullets `title`, `items//text`; metric `label|caption`; bar-chart `title|caption`, `bars//label`; flow `title`, `steps//label|detail`; quote `quote|attribution|role` only when the quote has no source; cta `title|subtitle`) — only fields the scene already has. A statement's emphasis must stay part of its text. Numbers, number prefixes/suffixes/units, the cta address, claim references, component, layout and background are not editable here. The text is trimmed and capped by the document schema (narration 600 characters; on-screen text 24–200 depending on the field). The edit is validated like the Digital Twin's own saves: a number that no claim of the scene backs, a link or e-mail address, an address spelled out in narration or more than 50 narration words is refused (422 with the validator's `errors`). An accepted edit creates a new version; the narration is re-made in the background (only an edited scene is voiced again and charged), and the Digital Twin's face is recorded again only when the narration changed. An export estimate for the previous version is stale afterwards. `revision` (the version you edited) is required. A narration edit is refused up front when the video would clearly leave its length (55–65 s for a 1-minute video, 170–190 s for a 3-minute one; 422 NARRATION_TIMING with the projected total and the word range that fits). Not while the Digital Twin is still building the video (409 BUILD_IN_PROGRESS). Fields you edited are listed on later versions as `ownerEdited` until the Digital Twin rewrites them. Owner only; 30 edits per minute. parameters: - in: path name: id required: true schema: type: string - in: path name: sceneId required: true schema: type: string example: governance requestBody: required: true content: application/json: schema: type: object required: - field - text - revision properties: field: type: string example: items/1/text description: '`narration` or a props text path' text: type: string example: Your knowledge stays in the IP Vault revision: type: integer example: 3 description: >- The revision number the edit was made on (the head's `headRevision`) responses: '200': description: >- Saved as a new version — or `unchanged: true` (same text, nothing saved; `revision` is the current one) content: application/json: schema: type: object properties: success: type: boolean example: true unchanged: type: boolean description: Present (true) only when the text was already that presentationId: type: string sceneId: type: string field: type: string revision: type: integer example: 4 version: type: integer example: 2 description: The new version (each edit is its own version) narrationChanged: type: boolean narrationQueued: type: boolean description: The narration of the new version is being made estimatedTotal: type: number nullable: true example: 64.1 description: Projected video length (narration edits) presenterRerecord: type: boolean description: The Digital Twin's face will be recorded again presenterCreditsEstimate: type: number nullable: true description: Estimated credits for that recording contentValid: type: boolean report: type: object properties: errorCount: type: integer warningCount: type: integer errors: type: array items: $ref: '#/components/schemas/PresentationValidationIssue' warnings: type: array items: $ref: '#/components/schemas/PresentationValidationIssue' '400': description: >- INVALID_REQUEST (incl. revision missing), UNKNOWN_SCENE, UNKNOWN_FIELD, INVALID_TEXT (blank), TEXT_TOO_LONG { maxLength } '401': description: Not signed in '403': description: FEATURE_OFF (switched off just now) '404': description: Not yours, being deleted, or the feature is off '409': description: >- STALE_HEAD { headRevision } (a newer version exists: reload and edit again), NOT_EDITABLE (no version yet, or the current one does not pass validation), BUILD_IN_PROGRESS { scope? } (this presentation is being built by the Digital Twin; with scope 'another', ANOTHER of the owner's presentations is being built or narrated after a save, so this one cannot move yet: try again when it is done), PRESENTATION_MAX_REVISIONS '422': description: >- SCHEMA_INVALID or CONTENT_INVALID — `errors` lists the validator's findings (code, path, message); NARRATION_TIMING { estimatedTotal, min, max, wordsAllowed:[lo,hi] }; EMPHASIS_MISSING content: application/json: schema: type: object properties: success: type: boolean example: false code: type: string example: CONTENT_INVALID errors: type: array items: $ref: '#/components/schemas/PresentationValidationIssue' '429': description: >- RATE_LIMITED (30 edits/min), REVISION_CAP (40 edits per presentation per day) '503': description: PRESENTATION_UNAVAILABLE security: - apiKeyAuth: [] components: schemas: PresentationValidationIssue: type: object properties: level: type: string example: content code: type: string example: UNSOURCED_NUMERAL path: type: string example: /scenes/4/props/items/1/text message: type: string securitySchemes: apiKeyAuth: type: apiKey in: header name: x-access-token description: JWT token passed in x-access-token header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.