> ## 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.

# Écrire la configuration du widget (auth : clé lsk_)

> Remplace la configuration du widget. Le corps est NORMALISÉ avant écriture : une couleur qu'on ne sait pas lire retombe sur le défaut, un champ inconnu est ignoré. Ce qui est stocké est donc toujours ce qui sera servi — pas une intention qu'un lecteur devra interpréter.

Réservée à la clé : un widget ne réécrit pas son propre thème.

`client` permet à une clé `platform` d'écrire celle d'un autre — c'est ce que fait la console quand un partenaire change ses couleurs.



## OpenAPI

````yaml /openapi.json put /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:
    put:
      tags:
        - b2b
      summary: 'Écrire la configuration du widget (auth : clé lsk_)'
      description: >-
        Remplace la configuration du widget. Le corps est NORMALISÉ avant
        écriture : une couleur qu'on ne sait pas lire retombe sur le défaut, un
        champ inconnu est ignoré. Ce qui est stocké est donc toujours ce qui
        sera servi — pas une intention qu'un lecteur devra interpréter.


        Réservée à la clé : un widget ne réécrit pas son propre thème.


        `client` permet à une clé `platform` d'écrire celle d'un autre — c'est
        ce que fait la console quand un partenaire change ses couleurs.
      operationId: set_embed_config_v2_embed_config_put
      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.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EmbedConfigUpdate'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response Set Embed Config V2 Embed Config Put
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - lsk: []
components:
  schemas:
    EmbedConfigUpdate:
      properties:
        theme:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Theme
        features:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Features
        labels:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Labels
        branding:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Branding
      type: object
      title: EmbedConfigUpdate
      description: 'Le corps d''une écriture. Volontairement libre : `b2b.normalize` décide.'
    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.