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

# Crear una sede

> Crea una nueva sede para la institución autenticada. Solo `name` es obligatorio; los campos omitidos usan los valores por defecto del servidor. El nombre de la sede debe ser único dentro de la institución: un duplicado devuelve un 409. Una vez creada, la sede puede referenciarse como `institutionalBranchName` al crear cuentas.



## OpenAPI

````yaml /es/scribe-api/openapi-institutional.json post /v1/institutional/branches
openapi: 3.1.0
info:
  title: Scribe Public API
  description: >-
    API REST externa para integración con la plataforma Telepatia. Autentíquese
    con claves API, establezca el contexto de consulta y consulte sesiones de
    scribe.
  version: 0.1.0
servers:
  - url: https://scribe-api.telepatia.ai
    description: Production
security:
  - BearerAuth: []
paths:
  /v1/institutional/branches:
    post:
      tags:
        - Institutional
        - Institutional
      summary: Crear una sede
      description: >-
        Crea una nueva sede para la institución autenticada. Solo `name` es
        obligatorio; los campos omitidos usan los valores por defecto del
        servidor. El nombre de la sede debe ser único dentro de la institución:
        un duplicado devuelve un 409. Una vez creada, la sede puede
        referenciarse como `institutionalBranchName` al crear cuentas.
      operationId: api_institutional_branch_created_v1_institutional_branches_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateBranchRequest'
            example:
              address: 'Av. 7 #12-34'
              main: false
              name: Sede Norte
              type: single
        required: true
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateBranchResponse'
        '400':
          description: >-
            Solicitud incorrecta — parámetros inválidos, fallos de validación o
            campos faltantes.
          content:
            application/json:
              examples:
                parameter_missing:
                  summary: Missing required field
                  value:
                    error:
                      type: invalid_request_error
                      code: parameter_missing
                      message: name is required.
                      param: name
                      requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30
                parameter_invalid:
                  summary: Invalid field value
                  value:
                    error:
                      type: invalid_request_error
                      code: parameter_invalid
                      message: >-
                        idCountry must be a valid country name, ISO alpha-2, or
                        ISO alpha-3 code.
                      param: idCountry
                      requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30
                account_invalid:
                  summary: Invalid account
                  value:
                    error:
                      type: invalid_request_error
                      code: account_invalid
                      message: Account has no valid authId.
                      requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: No autorizado — clave API faltante o inválida.
          content:
            application/json:
              examples:
                authentication_required:
                  summary: Invalid or missing API key
                  value:
                    error:
                      type: authentication_error
                      code: authentication_required
                      message: Invalid API key.
                      requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Prohibido — la clave API no puede realizar esta operación.
          content:
            application/json:
              examples:
                permission_denied:
                  summary: Caller lacks permission for this resource
                  value:
                    error:
                      type: permission_error
                      code: permission_denied
                      message: You do not have permission to access this resource.
                      requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30
                permission_denied_role:
                  summary: API key's account role is not allowed this operation
                  value:
                    error:
                      type: permission_error
                      code: permission_denied
                      message: >-
                        Your API key is not allowed to create accounts. Account
                        creation requires an institutional API key; this key is
                        scoped to a doctor account.
                      requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Conflicto — el recurso ya existe o está en estado conflictivo.
          content:
            application/json:
              examples:
                resource_conflict:
                  summary: Resource conflict
                  value:
                    error:
                      type: invalid_request_error
                      code: resource_conflict
                      message: >-
                        consultationInternalId is already in use by a different
                        consultation.
                      param: consultationInternalId
                      requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Servicio no disponible — una dependencia externa no está disponible.
          content:
            application/json:
              examples:
                service_unavailable:
                  summary: External service unavailable
                  value:
                    error:
                      type: api_error
                      code: service_unavailable
                      message: >-
                        The service is temporarily unavailable. Please try again
                        later.
                      requestId: 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - BearerAuth: []
components:
  schemas:
    CreateBranchRequest:
      properties:
        name:
          type: string
          maxLength: 255
          title: Name
          examples:
            - Sede Norte
        type:
          anyOf:
            - $ref: '#/components/schemas/InstitutionalBranchType'
            - type: 'null'
          examples:
            - single
        visible:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Visible
          examples:
            - true
        main:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Main
          examples:
            - false
        order:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          title: Order
          examples:
            - 0
        description:
          anyOf:
            - type: string
              maxLength: 1000
            - type: 'null'
          title: Description
        address:
          anyOf:
            - type: string
              maxLength: 500
            - type: 'null'
          title: Address
          examples:
            - 'Av. 7 #12-34'
        IPS:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Ips
        coordinates:
          anyOf:
            - $ref: '#/components/schemas/Coordinates'
            - type: 'null'
        expectedConsultations:
          anyOf:
            - type: integer
              minimum: 0
            - type: 'null'
          title: Expectedconsultations
        branchManagerAccountIds:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Branchmanageraccountids
        cdssConfigurationId:
          anyOf:
            - type: string
            - type: 'null'
          title: Cdssconfigurationid
        auditConfigurationId:
          anyOf:
            - type: string
            - type: 'null'
          title: Auditconfigurationid
        sessionStartLabel:
          anyOf:
            - $ref: '#/components/schemas/SessionStartLabel'
            - type: 'null'
      type: object
      required:
        - name
      title: CreateBranchRequest
      description: >-
        Request body for creating an institution branch.


        Mirrors datalayer's branch input. Only ``name`` is required; omitted
        fields

        fall back to datalayer defaults (``visible=true``, ``type=single``,

        ``main=false``, ``order=0``, ``IPS=[]``). The branch ``id`` is generated

        server-side.
      examples:
        - address: 'Av. 7 #12-34'
          main: false
          name: Sede Norte
          type: single
    CreateBranchResponse:
      properties:
        id:
          type: string
          title: Id
          description: Server-generated branch id.
        name:
          type: string
          title: Name
          examples:
            - Sede Norte
        type:
          anyOf:
            - type: string
            - type: 'null'
          title: Type
          examples:
            - single
        visible:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Visible
        main:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Main
        order:
          anyOf:
            - type: integer
            - type: 'null'
          title: Order
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        address:
          anyOf:
            - type: string
            - type: 'null'
          title: Address
        IPS:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Ips
        coordinates:
          anyOf:
            - $ref: '#/components/schemas/Coordinates'
            - type: 'null'
        expectedConsultations:
          anyOf:
            - type: integer
            - type: 'null'
          title: Expectedconsultations
        branchManagerAccountIds:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Branchmanageraccountids
        cdssConfigurationId:
          anyOf:
            - type: string
            - type: 'null'
          title: Cdssconfigurationid
        auditConfigurationId:
          anyOf:
            - type: string
            - type: 'null'
          title: Auditconfigurationid
        sessionStartLabel:
          anyOf:
            - type: string
            - type: 'null'
          title: Sessionstartlabel
      type: object
      required:
        - id
        - name
      title: CreateBranchResponse
      description: Response body after creating an institution branch.
      examples:
        - address: 'Av. 7 #12-34'
          id: b1f2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d
          main: false
          name: Sede Norte
          order: 0
          type: single
          visible: true
    ErrorResponse:
      description: Envoltorio estandarizado de respuesta de error.
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetailWithRequestId'
      required:
        - error
      title: ErrorResponse
      type: object
    InstitutionalBranchType:
      type: string
      enum:
        - single
        - multi
      title: InstitutionalBranchType
      description: Branch type — single site or multi-site.
    Coordinates:
      properties:
        latitude:
          type: number
          maximum: 90
          minimum: -90
          title: Latitude
          examples:
            - 4.711
        longitude:
          type: number
          maximum: 180
          minimum: -180
          title: Longitude
          examples:
            - -74.072
      type: object
      required:
        - latitude
        - longitude
      title: Coordinates
      description: Geographic coordinates of a branch.
    SessionStartLabel:
      type: string
      enum:
        - consultation
        - reading
      title: SessionStartLabel
      description: Wording the scribe clients use on the start-session button.
    ErrorDetailWithRequestId:
      description: >-
        Top-level error object: :class:`ErrorDetail` plus the request
        correlation id.


        Kept as a subclass rather than a field on ``ErrorDetail`` because
        ``ErrorDetail`` is

        also the per-item error shape inside the batch account-creation response

        (``BatchAccountResult.error``), which is serialized with nulls included.
        Adding the

        field there would publish ``"requestId": null`` on an HTTP 200, and
        there is only

        ever one request id per batch anyway -- batch callers read the
        ``X-Request-ID``

        response header.
      properties:
        type:
          description: Broad error category for high-level handling.
          examples:
            - invalid_request_error
          title: Type
          type: string
        code:
          description: Machine-readable error code. Clients should switch on this value.
          examples:
            - parameter_invalid
          title: Code
          type: string
        message:
          description: Human-readable error message ending with a period.
          examples:
            - >-
              idCountry must be a valid country name, ISO alpha-2, or ISO
              alpha-3 code.
          title: Message
          type: string
        param:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: The request field that caused the error, if applicable.
          examples:
            - idCountry
          title: Param
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          default: null
          description: Optional structured, machine-readable context for the error.
          examples:
            - pendingConsultations:
                - sessionId: abc123
                  url: https://...
          title: Details
        requestId:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            Unique id for this request, identical to the X-Request-ID response
            header. Quote it when contacting support.
          examples:
            - 3f9a1c2e-5b7d-4a21-9f0c-8e6d4b2a1c30
          title: Requestid
      required:
        - type
        - code
        - message
      title: ErrorDetailWithRequestId
      type: object
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Clave API enviada como token Bearer

````