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

# Create Spot Transcription

> Re-transcribe part of an existing run, without redoing the whole transcript.

Transcription drifts on a noisy passage, a crosstalk section, or a stretch in another language. Rather than re-running the whole job, name the run and the window in seconds and only that span is transcribed again.

Give `source_language` when the window is in a different language from the rest of the run, or set `auto_detect_language` to have it detected. Omit both and the run's own source language is used.

Omit `start_seconds` and `end_seconds` to re-transcribe the whole run.

Track progress by polling [`/spot-transcription/{task_id}`](get-spot-transcription-status) with the `task_id` returned in the response.


## OpenAPI

````yaml post /spot-transcription
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers:
  - url: https://client.camb.ai/apis
security: []
paths:
  /spot-transcription:
    post:
      tags:
        - Spot Transcription
      summary: Create Spot Transcription
      operationId: create_spot_transcription_spot_transcription_post
      parameters:
        - name: traceparent
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Traceparent
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateSpotTranscriptionRequestPayload'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrchestratorPipelineCallResult'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    CreateSpotTranscriptionRequestPayload:
      properties:
        run_id:
          type: integer
          exclusiveMinimum: 0
          title: Run Id
          description: The run to re-transcribe. Must already have a transcript.
        revision_num:
          anyOf:
            - type: integer
              exclusiveMinimum: 0
            - type: 'null'
          title: Revision Num
          description: Revision to re-transcribe. Defaults to the run's latest revision.
        start_seconds:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
          title: Start Seconds
          description: >-
            Start of the window to re-transcribe. Defaults to the start of the
            media.
        end_seconds:
          anyOf:
            - type: number
              exclusiveMinimum: 0
            - type: 'null'
          title: End Seconds
          description: >-
            End of the window to re-transcribe. Defaults to the end of the
            media.
        source_language:
          anyOf:
            - $ref: '#/components/schemas/Languages'
            - type: 'null'
          description: >-
            Language spoken in the window. Defaults to the run's source
            language.
        auto_detect_language:
          type: boolean
          title: Auto Detect Language
          description: Detect the spoken language instead of supplying source_language.
          default: false
      type: object
      required:
        - run_id
      title: CreateSpotTranscriptionRequestPayload
    OrchestratorPipelineCallResult:
      properties:
        task_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Task Id
      type: object
      required:
        - task_id
      title: OrchestratorPipelineCallResult
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Languages:
      type: integer
      title: Language ID
      description: >-
        Numeric language ID. Use [`GET
        /source-languages`](/api-reference/endpoint/get-source-languages) for
        valid `source_language` values and [`GET
        /target-languages`](/api-reference/endpoint/get-target-languages) for
        valid output `language` values. For example, `1` is English (US) and
        `54` is Spanish (Spain).
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        The `x-api-key` is a custom header required for authenticating requests
        to our API. Include this header in your request with the appropriate API
        key value to securely access our endpoints. You can find your API key(s)
        in the 'API' section of our studio website.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.