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

# Set inbound carrier authentication



## OpenAPI

````yaml /openapi.json put /v1/carrier-connections/{carrier_connection_id}/inbound-auth
openapi: 3.1.0
info:
  title: Leamout API
  version: 1.0.0
  description: The Leamout API for programmable communications.
servers:
  - url: https://api.leamout.com
security:
  - BearerAuth: []
tags:
  - name: Voice applications
    description: Programmable voice applications and inbound bindings.
  - name: Calls
    description: Durable calls and live call control.
  - name: SIP domains
    description: Organization-owned SIP namespaces.
  - name: SIP subscribers
    description: SIP identities and credentials.
  - name: Carrier providers
    description: Carrier provider definitions available to connections.
  - name: Carrier connections
    description: >-
      Organization carrier relationships, authentication, policy, and
      validation.
  - name: Trunks
    description: BYOC and managed SIP trunks and their physical endpoints.
  - name: Numbers
    description: BYOC and managed phone-number resources.
  - name: Recordings
    description: Call recording metadata and playback.
  - name: Conferences
    description: Conference resources and participant controls.
  - name: Realtime
    description: Short-lived realtime/WebRTC credentials.
  - name: Webhooks
    description: Webhook endpoints, secrets, tests, deliveries, and retries.
paths:
  /v1/carrier-connections/{carrier_connection_id}/inbound-auth:
    parameters:
      - $ref: '#/components/parameters/CarrierConnectionId'
    put:
      tags:
        - Carrier connections
      summary: Set inbound carrier authentication
      operationId: setCarrierInboundAuth
      requestBody:
        $ref: '#/components/requestBodies/InboundAuth'
      responses:
        '200':
          description: Authentication updated
components:
  parameters:
    CarrierConnectionId:
      name: carrier_connection_id
      in: path
      required: true
      schema:
        type: string
        format: uuid
  requestBodies:
    InboundAuth:
      required: true
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/InboundAuth'
  schemas:
    InboundAuth:
      type: object
      required:
        - method
      properties:
        method:
          type: string
        username:
          type: string
        realm:
          type: string
        secret:
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Organization credential
      description: Organization bearer credential beginning with lm_org_.

````