> ## Documentation Index > Fetch the complete documentation index at: https://docs.lighthousefh.com/llms.txt > Use this file to discover all available pages before exploring further. # Put v1clips ## OpenAPI ````yaml /openapi.json put /v1/clips/{uuid} openapi: 3.1.0 info: title: Lighthouse API description: Lighthouse funeral home management API license: name: '' version: 1.0.0 servers: - url: https://api.lighthousefh.com description: Production security: - bearer_auth: [] tags: - name: Health description: Health check endpoints - name: Cases description: Case management - name: Calls description: Call recordings and transcriptions - name: Clips description: Short audio clips and transcripts - name: Users description: User management - name: Organizations description: Organization management - name: Locations description: Location management - name: Case Data description: Custom case data values - name: Case Data Fields description: Custom case data field definitions - name: Generations description: User-sourced generation overrides - name: Generation Templates description: AI generation templates - name: Generation Feedback description: End-user feedback on generations - name: Generation Labels description: Generation quality labels - name: Generation Quality Test description: Generation quality testing - name: Generation Template Dependencies description: Template dependency management - name: Organization Template Status description: Organization-level template status - name: Score Instructions description: Score instructions for generation templates - name: Tasks description: Case tasks - name: Conversations description: Assistant chat conversations - name: User Preferences description: User preference settings - name: User Managers description: User-manager relationships - name: User Permissions description: User permission management - name: Roleplay Categories description: Roleplay category (skill) catalog - name: Roleplay Complications description: Roleplay complications catalog - name: Roleplay Personas description: Roleplay persona catalog - name: Roleplay Phases description: Roleplay phase catalog - name: Roleplay Runs description: Completed roleplay runs - name: Roleplay Scenarios description: Roleplay scenarios - name: Roleplay Voices description: Roleplay voice catalog - name: Scenario Score Templates description: Scenario scoring template attachments paths: /v1/clips/{uuid}: put: tags: - Clips operationId: update_clip_handler parameters: - name: uuid in: path description: Clip UUID required: true schema: type: string format: uuid requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateClipRequest' required: true responses: '200': description: Clip updated content: application/json: schema: $ref: '#/components/schemas/ApiResponse_Clip' '400': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ApiError' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ApiError' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ApiError' '404': description: Clip not found content: application/json: schema: $ref: '#/components/schemas/ApiError' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ApiError' security: - bearer_auth: [] components: schemas: UpdateClipRequest: type: object required: - tags properties: tags: type: array items: $ref: '#/components/schemas/ClipTag' ApiResponse_Clip: type: object required: - status - timestamp properties: data: type: object required: - uuid - organization_uuid - created_by - tags - status - offset_ms - created_at - updated_at properties: call_uuid: type: - string - 'null' format: uuid created_at: type: string format: date-time created_by: type: string format: uuid deleted_at: type: - string - 'null' format: date-time deleted_by: type: - string - 'null' format: uuid duration: type: - integer - 'null' format: int32 file_format: type: - string - 'null' file_name: type: - string - 'null' file_path: type: - string - 'null' file_size: type: - integer - 'null' format: int64 offset_ms: type: integer format: int64 organization_uuid: type: string format: uuid share_link_expires_at: type: - string - 'null' format: date-time status: $ref: '#/components/schemas/ClipStatus' tags: type: array items: $ref: '#/components/schemas/ClipTag' transcript: oneOf: - type: 'null' - $ref: '#/components/schemas/Transcript' updated_at: type: string format: date-time uuid: type: string format: uuid message: type: - string - 'null' request_id: type: - string - 'null' status: type: string timestamp: type: string format: date-time ApiError: type: object required: - status - error - message - status_code - timestamp properties: error: type: string message: type: string request_id: type: - string - 'null' status: type: string status_code: type: integer format: int32 minimum: 0 timestamp: type: string format: date-time ClipTag: type: string enum: - need_help - did_well - funny ClipStatus: type: string enum: - processing - ready - failed Transcript: type: object required: - source properties: source: $ref: '#/components/schemas/TranscriptSource' words: type: array items: $ref: '#/components/schemas/Word' TranscriptSource: type: string description: >- How the transcript entered our system: STT vendor for call paths, or LiveKit room streams for roleplay (STT under the agent is not recorded here). enum: - deepgram - assembly_ai - livekit Word: type: object description: A single word with timestamps and diarization (stored format) required: - text - start_ms - end_ms - confidence properties: confidence: type: number format: double end_ms: type: integer format: int64 speaker: type: - string - 'null' start_ms: type: integer format: int64 text: type: string securitySchemes: bearer_auth: type: http scheme: bearer ````