> ## 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 un fil

> Idempotent : l'app sauvegarde le fil entier à chaque stabilisation, et deux envois du même état laissent une seule ligne.

`updated_at` est posé par le SERVEUR. Le laisser au client rendrait la synchronisation dépendante d'horloges qu'on ne contrôle pas : un téléphone en avance ferait disparaître ses propres modifications de la fenêtre `since` des autres appareils.

Écrire dans un fil supprimé le ressuscite — l'utilisateur écrit dedans, donc il le veut.



## OpenAPI

````yaml /openapi.json put /v2/conversations/{conversation_id}
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/conversations/{conversation_id}:
    put:
      tags:
        - query
      summary: Écrire un fil
      description: >-
        Idempotent : l'app sauvegarde le fil entier à chaque stabilisation, et
        deux envois du même état laissent une seule ligne.


        `updated_at` est posé par le SERVEUR. Le laisser au client rendrait la
        synchronisation dépendante d'horloges qu'on ne contrôle pas : un
        téléphone en avance ferait disparaître ses propres modifications de la
        fenêtre `since` des autres appareils.


        Écrire dans un fil supprimé le ressuscite — l'utilisateur écrit dedans,
        donc il le veut.
      operationId: put_conversation_v2_conversations__conversation_id__put
      parameters:
        - name: conversation_id
          in: path
          required: true
          schema:
            type: string
            title: Conversation Id
        - name: X-Locus-User-Ref
          in: header
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 200
            description: >-
              Le compte, tel que l'intégrateur le nomme — pour l'app Locus,
              l'identifiant Clerk. Affirmé par l'intégrateur, qui en répond ;
              core ne peut pas le vérifier et cloisonne dessus.
            title: X-Locus-User-Ref
          description: >-
            Le compte, tel que l'intégrateur le nomme — pour l'app Locus,
            l'identifiant Clerk. Affirmé par l'intégrateur, qui en répond ; core
            ne peut pas le vérifier et cloisonne dessus.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutConversation'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConversationBody'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - lsk: []
components:
  schemas:
    PutConversation:
      properties:
        title:
          type: string
          maxLength: 500
          title: Title
          default: ''
        payload:
          additionalProperties: true
          type: object
          title: Payload
          description: 'Le fil, opaque au core : messages, contexte clinique, réglages.'
        has_patient_data:
          type: boolean
          title: Has Patient Data
          description: >-
            Le fil porte-t-il un contexte clinique ? Déclaré par l'app, qui
            seule lit le payload. Sert la liste — et rend mesurable, plutôt que
            supposé, ce que l'historique contient.
          default: false
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At
          description: >-
            La date de création connue du client. Omise, le défaut de la table
            fait foi — et une sauvegarde ultérieure ne la réécrit pas.
      type: object
      title: PutConversation
    ConversationBody:
      properties:
        id:
          type: string
          title: Id
        title:
          type: string
          title: Title
          default: ''
        created_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Created At
        updated_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Updated At
        has_patient_data:
          type: boolean
          title: Has Patient Data
          default: false
        payload:
          additionalProperties: true
          type: object
          title: Payload
      type: object
      required:
        - id
      title: ConversationBody
    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).
      scheme: bearer

````