> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trysela.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Live Call

> Updates a live call for this lead with connected representative information and other external identifiers. This endpoint is used when a customer's CRM notifies us that a loan officer picked up a transferred call. The endpoint will find the appropriate chat (using connected_timestamp if provided, otherwise an active call, a recent warm transfer, or a recent blind transfer/escalation) and link the representative to it. If no matching representative exists, a new one will be created. The external_id field is required and must be unique per company.



## OpenAPI

````yaml /Sela_API.yaml patch /api/leads/{id}/live-call/
openapi: 3.0.3
info:
  title: Sela API
  version: 1.0.2
  description: >-
    Create and manage leads, configure outbound webhook subscriptions, and use
    customer-specific lead ingestion workflows. Unless an endpoint says
    otherwise, authenticate with `Authorization: Token <api-key>`.
servers:
  - url: https://api.trysela.com/
    description: Production API
security: []
tags:
  - name: Leads
    description: Create, retrieve, update, and schedule customer leads.
  - name: Call Control
    description: Pause or resume outbound calling for an API user.
  - name: Lead Types
    description: >-
      Discover lead categories and the public metadata fields accepted for each
      one.
  - name: Webhooks
    description: >-
      Manage subscriptions that deliver lead and call events to customer
      systems.
  - name: Lead Ingestion
    description: >-
      Submit provider-specific lead payloads through ingestion URLs configured
      by Sela.
  - name: File Ingestion
    description: Request temporary upload URLs for configured CSV ingestion sources.
paths:
  /api/leads/{id}/live-call/:
    patch:
      tags:
        - Leads
      summary: Update Live Call
      description: >-
        Updates a live call for this lead with connected representative
        information and other external identifiers. This endpoint is used when a
        customer's CRM notifies us that a loan officer picked up a transferred
        call. The endpoint will find the appropriate chat (using
        connected_timestamp if provided, otherwise an active call, a recent warm
        transfer, or a recent blind transfer/escalation) and link the
        representative to it. If no matching representative exists, a new one
        will be created. The external_id field is required and must be unique
        per company.
      operationId: leads_live_call_partial_update
      parameters:
        - in: path
          name: id
          schema:
            type: integer
          description: A unique integer value identifying this lead.
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - connected_representative
              properties:
                connected_representative:
                  type: object
                  required:
                    - external_id
                  properties:
                    external_id:
                      type: string
                      minLength: 1
                      maxLength: 255
                      description: >-
                        Your unique identifier for the representative. Must be
                        unique per company.
                    phone_number:
                      type: string
                      nullable: true
                    email:
                      type: string
                      format: email
                      nullable: true
                    active:
                      type: boolean
                    metadata:
                      type: object
                      additionalProperties: true
                other_external_identifiers:
                  type: object
                  additionalProperties: true
                  nullable: true
                  description: Other identifiers from the customer's systems.
                connected_timestamp:
                  type: string
                  format: date-time
                  nullable: true
                  description: Timestamp when the representative connected with the lead.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LiveCallResponse'
              examples:
                LiveCallUpdated:
                  value:
                    chat_id: 12345
                    representative_id: 67
                    representative_external_id: REP-123
                  summary: Live call updated
          description: Live call successfully updated with representative information.
        '400':
          description: Bad Request - missing or invalid parameters.
        '404':
          description: No suitable chat found for this lead.
      security:
        - tokenAuth: []
components:
  schemas:
    LiveCallResponse:
      type: object
      description: Serializer for the response of the live call endpoint.
      properties:
        chat_id:
          type: integer
          description: The ID of the chat that was updated.
        representative_id:
          type: integer
          description: The ID of the connected representative.
        representative_external_id:
          type: string
          nullable: true
          description: The external ID of the connected representative, or null if not set.
      required:
        - chat_id
        - representative_id
  securitySchemes:
    tokenAuth:
      type: apiKey
      in: header
      name: Authorization
      description: Token-based authentication with required prefix "Token"

````