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

# La configuration du widget — thème, fonctionnalités, libellés

> Ce que le widget applique. Le client est résolu depuis le crédentiel (clé ou jeton) : le widget n'a pas à dire qui il est, il le prouve.

Une configuration absente ou incomplète rend les DÉFAUTS, jamais une erreur : un widget dont la configuration est cassée s'ouvre aux couleurs de Locus plutôt que de rester noir.

`client` permet à une clé `platform` de lire celle d'un autre — c'est ainsi que la console montre à un partenaire son propre thème, sans que nous détenions sa clé.

`features` est ce que le widget peut RÉELLEMENT offrir : le choix du client ET, pour une fonctionnalité en déploiement, l'accord de Locus. `preferences` rend le choix du client tel qu'il l'a écrit.



## OpenAPI

````yaml /openapi.json get /v2/embed-config
openapi: 3.1.0
info:
  title: Locus API
  description: >-
    Locus knowledge layer — REST over a clinical knowledge graph.


    Two categories of surface:

    - **query** (read) — `/v2/retrieve` and `/v2/retrieve/stream`
    (knowledge-graph retrieval, MKF 0.1.3), `/v2/drugs/*` (the full text of an
    SmPC section a retrieval truncated) and `/v2/feedback` (a thumb on a traced
    answer);

    - **ops** — `/health`.


    The write plane (PDF → Neo4j graph: ingest, summarize, MKU extraction) is
    NOT exposed over HTTP — it is a batch pipeline driven by the `locus` CLI,
    which runs where the source PDFs are.
  version: 0.5.0
servers:
  - url: https://core.locusmedical.fr
    description: Production
security: []
paths:
  /v2/embed-config:
    get:
      tags:
        - b2b
      summary: La configuration du widget — thème, fonctionnalités, libellés
      description: >-
        Ce que le widget applique. Le client est résolu depuis le crédentiel
        (clé ou jeton) : le widget n'a pas à dire qui il est, il le prouve.


        Une configuration absente ou incomplète rend les DÉFAUTS, jamais une
        erreur : un widget dont la configuration est cassée s'ouvre aux couleurs
        de Locus plutôt que de rester noir.


        `client` permet à une clé `platform` de lire celle d'un autre — c'est
        ainsi que la console montre à un partenaire son propre thème, sans que
        nous détenions sa clé.


        `features` est ce que le widget peut RÉELLEMENT offrir : le choix du
        client ET, pour une fonctionnalité en déploiement, l'accord de Locus.
        `preferences` rend le choix du client tel qu'il l'a écrit.
      operationId: embed_config_v2_embed_config_get
      parameters:
        - name: client
          in: query
          required: false
          schema:
            type: string
            maxLength: 200
            description: >-
              Agir au nom d'un AUTRE client, par son `slug` ou son identifiant.
              Réservé aux clés `platform` — la console que nous servons, où
              c'est une personne qui se connecte et non une clé. Omis : le
              client de la clé présentée, comme toujours.
            default: ''
            title: Client
          description: >-
            Agir au nom d'un AUTRE client, par son `slug` ou son identifiant.
            Réservé aux clés `platform` — la console que nous servons, où c'est
            une personne qui se connecte et non une clé. Omis : le client de la
            clé présentée, comme toujours.
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Embed Config V2 Embed Config Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - lsk: []
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    lsk:
      type: http
      description: >-
        Locus API key — paste the raw `lsk_…` value (no 'Bearer ' prefix) — or a
        B2B session token minted by `POST /v2/session-token`.
      scheme: bearer

````

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