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

# Les éditeurs sur lesquels un retrieving peut être restreint

> Les valeurs admises par `sources` / `exclude_sources` de `POST /v2/retrieve`, triées par volume. `docs` compte les documents COURANTS de l'éditeur : une source sans document actif n'est pas listée, parce qu'y restreindre une question ne pourrait répondre que vide.

Le catalogue est mémorisé une heure côté serveur : il ne change qu'à l'ingestion d'un nouveau corpus.



## OpenAPI

````yaml /openapi.json get /v2/sources
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/sources:
    get:
      tags:
        - query
      summary: Les éditeurs sur lesquels un retrieving peut être restreint
      description: >-
        Les valeurs admises par `sources` / `exclude_sources` de `POST
        /v2/retrieve`, triées par volume. `docs` compte les documents COURANTS
        de l'éditeur : une source sans document actif n'est pas listée, parce
        qu'y restreindre une question ne pourrait répondre que vide.


        Le catalogue est mémorisé une heure côté serveur : il ne change qu'à
        l'ingestion d'un nouveau corpus.
      operationId: sources_v2_sources_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/RetrieveSource'
                type: array
                title: Response Sources V2 Sources Get
      security:
        - lsk: []
components:
  schemas:
    RetrieveSource:
      properties:
        id:
          type: string
          title: Id
          description: L'identifiant à passer dans `sources` — ex. « HAS ».
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
          description: Nom complet de l'éditeur.
        docs:
          type: integer
          title: Docs
          description: Documents courants publiés par cette source.
          default: 0
      type: object
      required:
        - id
      title: RetrieveSource
      description: >-
        Un éditeur du corpus, tel que `GET /v2/sources` le publie.


        `docs` compte les documents COURANTS : c'est ce qui dit si filtrer sur
        cette

        source rendra quelque chose. Une source dont plus aucun document n'est
        actif

        n'est pas listée — la publier ferait accepter une restriction qui ne
        peut

        répondre que vide.
  securitySchemes:
    lsk:
      type: http
      description: Locus API key — paste the raw `lsk_…` value (no 'Bearer ' prefix).
      scheme: bearer

````