Skip to main content
GET
Lire l'état public d'une session

Autorisations

Authorization
string
header
requis

Clé d'intégration préfixée nbq_live_, envoyée dans Authorization: Bearer nbq_live_… et résolue par l'authorizer Lambda de l'API Gateway publique. L'authorizer valide la clé, puis injecte en amont du service les headers de contexte x-tenant-id, x-nbq-id et x-scopesx-scopes étant la liste des scopes de la clé séparés par des virgules, par exemple runtime,configuration:read.

Ces headers ne sont jamais acceptés depuis le client : toute valeur entrante est écrasée. Une clé absente ou invalide produit 401 au niveau de la passerelle ; une clé valide sans le scope requis produit 403 avec le code insufficient_scope.

Paramètres de chemin

session_id
string
requis

Identifiant opaque de session attribué par NBQ à la création.

Required string length: 1 - 128

Réponse

État public courant.

request_id
string
requis
session_id
string
requis
client_reference
string | null
requis
status
enum<string>
requis
Options disponibles:
active,
completed,
stopped
turn_count
integer
requis
Plage requise: x >= 0
max_turns
integer
requis
Plage requise: x >= 1
turns_remaining
integer
requis
Plage requise: x >= 0
question_state
object
requis

Aucun index asked_ids, answered_ids ou refused_ids n'est persisté ni exposé : ces ensembles se reconstruisent depuis outcomes.

targets
object
requis

État sparse : seules les cibles réellement touchées sont présentes. Une cible absente est inconnue et sans couverture.

progress
object
requis
pending_decision
object | null
requis

Décision proposée et pas encore résolue. Les candidats sont réhydratés depuis la configuration épinglée : après un crash, relire la session suffit pour reprendre exactement où l'on s'était arrêté. Aucun jeton de reprise n'existe.

degraded
boolean
requis
versions
object
requis

La version de configuration épinglée par la session n'est pas exposée : le client ne la choisit pas et ne doit pas s'y adosser.