> ## Documentation Index > Fetch the complete documentation index at: https://docs.zelinqa.ai/llms.txt > Use this file to discover all available pages before exploring further. # Déclarer le résultat réel de la conversation > Enregistre ce que la conversation a produit, sans modifier rétroactivement le scoring ni l'état de la session. Le vocabulaire est volontairement générique : Zelinqa ne suppose pas qu'une conversation est toujours une qualification commerciale. `label` permet à l'intégrateur de nommer son propre résultat métier — « achat », « rendez-vous », « dossier complété ». ## OpenAPI ````yaml /openapi.fr.yaml post /v1/sessions/{session_id}/feedback openapi: 3.1.0 info: title: Zelinqa — API V1 version: 1.0.0 summary: >- Contrat public du runtime Zelinqa et de la configuration des bases de questions. description: >- Contrat public de l'API Zelinqa V1 sur https://api.zelinqa.ai. La clé API identifie le domaine et ses droits. Les mutations utilisent Idempotency-Key ; celles d'une session existante utilisent aussi state_version. Les sessions restent attachées à leur version publiée. contact: name: Zelinqa url: https://docs.zelinqa.ai license: name: Proprietary — Zelinqa SAS identifier: LicenseRef-Zelinqa-Proprietary servers: - url: https://api.zelinqa.ai description: API publique Zelinqa security: - ApiKeyAuth: [] tags: - name: sessions description: > Cycle de vie d'une conversation Zelinqa : création, sélection de la question suivante, mises à jour hors tour, reprise et retour de résultat. - name: configuration description: | Lecture et modification de la configuration éditoriale d'un domaine, puis publication asynchrone de l'artefact moteur. paths: /v1/sessions/{session_id}/feedback: post: tags: - sessions summary: Déclarer le résultat réel de la conversation description: > Enregistre ce que la conversation a produit, sans modifier rétroactivement le scoring ni l'état de la session. Le vocabulaire est volontairement générique : Zelinqa ne suppose pas qu'une conversation est toujours une qualification commerciale. `label` permet à l'intégrateur de nommer son propre résultat métier — « achat », « rendez-vous », « dossier complété ». operationId: submitSessionFeedback parameters: - $ref: '#/components/parameters/SessionId' - $ref: '#/components/parameters/IdempotencyKey' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/FeedbackRequest' examples: succes: summary: Résultat positif nommé par l'intégrateur value: result: success label: achat metadata: order_id: SO-99120 echec: summary: Conversation abandonnée value: result: failure label: abandon_panier responses: '202': description: Retour enregistré. content: application/json: schema: $ref: '#/components/schemas/FeedbackResponse' example: request_id: req_5f31 session_id: ses_01J8Z feedback_id: fbk_02K1 recorded_at: '2026-09-01T09:14:22Z' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/InsufficientScope' '404': $ref: '#/components/responses/UnknownSession' '409': $ref: '#/components/responses/IdempotencyConflict' '503': $ref: '#/components/responses/IdempotencyContention' components: parameters: SessionId: name: session_id in: path required: true schema: type: string minLength: 1 maxLength: 128 description: Identifiant opaque de session attribué par Zelinqa à la création. IdempotencyKey: name: Idempotency-Key in: header required: true schema: type: string minLength: 8 maxLength: 128 description: > Clé unique par mutation logique, choisie par l'appelant. Même clé et même corps renvoient exactement la réponse d'origine, sans rejouer l'effet : aucun retry ne double `turn_count`, un outcome, un événement, un feedback ou une publication. Même clé avec un corps différent produit `409 idempotency_key_reused`. Les enregistrements sont isolés par tenant et par opération, et sont purgés après **24 heures**. Passé ce délai, la même clé est traitée comme neuve. schemas: FeedbackRequest: type: object additionalProperties: false required: - result properties: result: type: string enum: - success - partial - failure description: > Vocabulaire générique : Zelinqa ne suppose pas qu'une conversation est une qualification commerciale. label: type: string minLength: 1 maxLength: 128 description: >- Nom du résultat métier choisi par l'intégrateur, par exemple « achat » ou « rendez-vous ». metadata: type: object additionalProperties: oneOf: - type: string maxLength: 256 - type: number - type: boolean - type: 'null' maxProperties: 50 description: > Faits courts de corrélation non interprétés par Zelinqa : identifiant CRM, montant, devise ou indicateur. Taille sérialisée maximale : 4 Kio. Les messages, réponses, résumés, prompts et transcripts sont refusés. FeedbackResponse: type: object additionalProperties: false required: - request_id - session_id - feedback_id - recorded_at properties: request_id: type: string session_id: type: string feedback_id: type: string recorded_at: type: string format: date-time ErrorEnvelope: type: object additionalProperties: false required: - code - message - request_id - details description: Enveloppe uniforme de toutes les erreurs métier. properties: code: $ref: '#/components/schemas/ErrorCode' message: type: string minLength: 1 request_id: type: string minLength: 1 details: type: object additionalProperties: true ErrorCode: type: string description: Catalogue fermé des erreurs métier V1. enum: - unauthorized - insufficient_scope - idempotency_contention - state_version_conflict - idempotency_key_reused - unknown_session - invalid_previous_turn - constraint_no_match - invalid_choice - compiled_artifact_unavailable - configuration_validation_failed - compilation_in_progress - unknown_configuration - unknown_compilation responses: Unauthorized: description: >- Réponse 401 possible au niveau de l'application. Une clé absente ou invalide est généralement refusée en 403 par la passerelle, sans enveloppe métier garantie. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: code: unauthorized message: Clé d'intégration absente ou invalide. request_id: req_9000 details: {} InsufficientScope: description: >- Accès refusé. La passerelle peut renvoyer 403 pour une clé absente, invalide, expirée, révoquée ou dépourvue du scope requis, sans enveloppe métier garantie. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: code: insufficient_scope message: Cette clé ne permet pas de publier une configuration. request_id: req_9001 details: required_scopes: - configuration:publish granted_scopes: - configuration:read - configuration:write UnknownSession: description: Session inconnue, ou appartenant à un autre tenant. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: code: unknown_session message: La session demandée est inconnue. request_id: req_9007 details: session_id: ses_inconnue IdempotencyConflict: description: La clé d'idempotence a déjà servi pour un corps différent. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: code: idempotency_key_reused message: Cette clé d'idempotence est déjà associée à une autre requête. request_id: req_9002 details: idempotency_key: create-session-8842 IdempotencyContention: description: > La clé d'idempotence n'a pas pu être réservée après deux tentatives, à cause d'un cycle anormal de requêtes concurrentes portant la même clé. Ce n'est **pas** une erreur du client et ce n'est pas un conflit : réessayer après un court délai a des chances d'aboutir. À distinguer de `idempotency_key_reused`, qui est définitif pour ce couple clé/corps. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: code: idempotency_contention message: La clé d'idempotence n'a pas pu être réservée, réessayez. request_id: req_9017 details: idempotency_key: next-ses01J8Z-turn-4 retry_after_seconds: 1 securitySchemes: ApiKeyAuth: type: http scheme: bearer bearerFormat: Zelinqa API key description: >- Envoyez la clé API dans Authorization: Bearer . Elle identifie le domaine et les droits autorisés. Ne transmettez pas d'en-têtes d'identité internes. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.