{
  "openapi": "3.0.0",
  "paths": {
    "/enrollments": {
      "post": {
        "description": "Identify an existing user with `userId`, or provide `user` to create the learner first. Enrolling twice is harmless.\n\nScope: `enrollments:write`.",
        "operationId": "createEnrollment",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "description": "Unique key per creating request (8–128 characters), retained 24 hours per client.",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_.:-]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEnrollmentRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/Enrollment"
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Invalid request (validation, cursor).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing, expired or revoked access token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Missing scope or organization module not available.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "A request with the same Idempotency-Key is in progress.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Idempotency-Key reused with a different request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded; see Retry-After.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "enrollments:write"
            ]
          }
        ],
        "summary": "Enroll a learner in a session",
        "tags": [
          "Enrollments"
        ]
      }
    },
    "/sessions/{sessionId}/progress": {
      "get": {
        "description": "Scope: `progress:read`.",
        "operationId": "listSessionProgress",
        "parameters": [
          {
            "name": "sessionId",
            "required": true,
            "in": "path",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "exclusiveMinimum": true
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "schema": {
              "default": 25,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "cursor",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/LearnerProgress"
                      }
                    },
                    "pagination": {
                      "type": "object",
                      "properties": {
                        "nextCursor": {
                          "nullable": true,
                          "description": "Opaque cursor of the next page, or null.",
                          "type": "string"
                        }
                      },
                      "required": [
                        "nextCursor"
                      ],
                      "additionalProperties": false
                    },
                    "session": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer"
                        },
                        "name": {
                          "nullable": true,
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "name"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "data",
                    "pagination",
                    "session"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Invalid request (validation, cursor).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing, expired or revoked access token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Missing scope or organization module not available.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded; see Retry-After.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "progress:read"
            ]
          }
        ],
        "summary": "Progress and results of the learners of a session",
        "tags": [
          "Progress"
        ]
      }
    },
    "/users": {
      "get": {
        "description": "Scope: `users:read`.",
        "operationId": "listUsers",
        "parameters": [
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "schema": {
              "default": 25,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            }
          },
          {
            "name": "cursor",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string",
              "maxLength": 200
            }
          },
          {
            "name": "email",
            "required": false,
            "in": "query",
            "description": "Exact email address.",
            "schema": {
              "description": "Exact email address.",
              "type": "string",
              "maxLength": 255,
              "format": "email",
              "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
            }
          },
          {
            "name": "status",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "active",
                "disabled"
              ]
            }
          },
          {
            "name": "role",
            "required": false,
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "LEARNER",
                "MANAGER",
                "ADMINISTRATOR"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/User"
                      }
                    },
                    "pagination": {
                      "type": "object",
                      "properties": {
                        "nextCursor": {
                          "nullable": true,
                          "description": "Opaque cursor of the next page, or null.",
                          "type": "string"
                        }
                      },
                      "required": [
                        "nextCursor"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "data",
                    "pagination"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Invalid request (validation, cursor).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing, expired or revoked access token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Missing scope or organization module not available.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded; see Retry-After.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "users:read"
            ]
          }
        ],
        "summary": "List the users of the organization",
        "tags": [
          "Users"
        ]
      },
      "post": {
        "description": "A disabled or suspended account is never reactivated (409 account_suspended). Accounts managed by an identity connector are refused (409 account_managed).\n\nScope: `users:write`.",
        "operationId": "createUser",
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "description": "Unique key per creating request (8–128 characters), retained 24 hours per client.",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_.:-]{8,128}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateUserRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/User"
                    },
                    "created": {
                      "type": "boolean",
                      "description": "False when an active account already existed."
                    }
                  },
                  "required": [
                    "data",
                    "created"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Invalid request (validation, cursor).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing, expired or revoked access token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Missing scope or organization module not available.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "A request with the same Idempotency-Key is in progress.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "Idempotency-Key reused with a different request.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded; see Retry-After.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "users:write"
            ]
          }
        ],
        "summary": "Create a learner, or return the active account with this email",
        "tags": [
          "Users"
        ]
      }
    },
    "/users/{id}": {
      "get": {
        "description": "Scope: `users:read`.",
        "operationId": "getUser",
        "parameters": [
          {
            "name": "id",
            "required": true,
            "in": "path",
            "schema": {
              "type": "integer",
              "minimum": 0,
              "exclusiveMinimum": true
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "$ref": "#/components/schemas/User"
                    }
                  },
                  "required": [
                    "data"
                  ],
                  "additionalProperties": false
                }
              }
            }
          },
          "400": {
            "description": "Invalid request (validation, cursor).",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing, expired or revoked access token.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Missing scope or organization module not available.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded; see Retry-After.",
            "content": {
              "application/problem+json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "type",
                    "title",
                    "status",
                    "detail",
                    "code"
                  ],
                  "properties": {
                    "type": {
                      "type": "string",
                      "description": "URI identifying the error code."
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "integer"
                    },
                    "detail": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string",
                      "description": "Stable machine-readable code."
                    },
                    "instance": {
                      "type": "string",
                      "description": "Request identifier (X-Request-Id)."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "required": [
                          "path",
                          "message"
                        ],
                        "properties": {
                          "path": {
                            "type": "string"
                          },
                          "message": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "users:read"
            ]
          }
        ],
        "summary": "Get a user of the organization",
        "tags": [
          "Users"
        ]
      }
    }
  },
  "info": {
    "title": "InTeach public API",
    "description": "REST API for integrating InTeach with HR, reporting, ITSM and automation tools.\n\nEvery token belongs to one organization; identifiers of other organizations answer 404.\n\nErrors use RFC 9457 `application/problem+json`. Lists use opaque cursors.",
    "version": "1.0.0",
    "contact": {}
  },
  "tags": [],
  "servers": [
    {
      "url": "https://api.example.com/api/v1",
      "description": "Replace with the API host of your InTeach environment"
    }
  ],
  "components": {
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://api.example.com/oauth/token",
            "scopes": {
              "users:read": "Lire les utilisateurs de l’organisation",
              "users:write": "Créer des apprenants",
              "enrollments:write": "Inscrire des apprenants à une diffusion",
              "progress:read": "Lire la progression et les résultats",
              "groups:read": "Lire les groupes et leurs membres",
              "catalog:read": "Lire les formations et les diffusions",
              "certifications:read": "Lire les attestations et certifications",
              "reports:read": "Exporter les données de reporting"
            }
          },
          "authorizationCode": {
            "authorizationUrl": "https://api.example.com/oauth/authorize",
            "tokenUrl": "https://api.example.com/oauth/token",
            "scopes": {
              "users:read": "Lire les utilisateurs de l’organisation",
              "users:write": "Créer des apprenants",
              "enrollments:write": "Inscrire des apprenants à une diffusion",
              "progress:read": "Lire la progression et les résultats",
              "groups:read": "Lire les groupes et leurs membres",
              "catalog:read": "Lire les formations et les diffusions",
              "certifications:read": "Lire les attestations et certifications",
              "reports:read": "Exporter les données de reporting"
            }
          }
        }
      }
    },
    "schemas": {
      "CreateEnrollmentRequest": {
        "$ref": "#/components/schemas/CreateEnrollmentRequest"
      },
      "CreateUserRequest": {
        "$ref": "#/components/schemas/CreateUserRequest"
      },
      "Enrollment": {
        "type": "object",
        "properties": {
          "userId": {
            "type": "integer"
          },
          "sessionId": {
            "type": "integer"
          }
        },
        "required": [
          "userId",
          "sessionId"
        ],
        "additionalProperties": false
      },
      "LearnerProgress": {
        "type": "object",
        "properties": {
          "enrollmentId": {
            "type": "integer"
          },
          "user": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer"
              },
              "email": {
                "nullable": true,
                "type": "string"
              },
              "firstname": {
                "nullable": true,
                "type": "string"
              },
              "lastname": {
                "nullable": true,
                "type": "string"
              }
            },
            "required": [
              "id",
              "email",
              "firstname",
              "lastname"
            ],
            "additionalProperties": false
          },
          "status": {
            "type": "string",
            "enum": [
              "ACTIVE",
              "SLOWING",
              "INACTIVE",
              "NOT_STARTED"
            ]
          },
          "completionPercent": {
            "type": "number"
          },
          "completedActivities": {
            "type": "integer"
          },
          "totalActivities": {
            "type": "integer"
          },
          "completedEvaluations": {
            "type": "integer"
          },
          "totalEvaluations": {
            "type": "integer"
          },
          "evaluationScore": {
            "nullable": true,
            "type": "number"
          },
          "masteryScore": {
            "type": "number"
          },
          "secondsSpent": {
            "type": "integer"
          },
          "firstActivityAt": {
            "nullable": true,
            "type": "string"
          },
          "lastActivityAt": {
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "enrollmentId",
          "user",
          "status",
          "completionPercent",
          "completedActivities",
          "totalActivities",
          "completedEvaluations",
          "totalEvaluations",
          "evaluationScore",
          "masteryScore",
          "secondsSpent",
          "firstActivityAt",
          "lastActivityAt"
        ],
        "additionalProperties": false
      },
      "User": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "email": {
            "type": "string"
          },
          "firstname": {
            "nullable": true,
            "type": "string"
          },
          "lastname": {
            "nullable": true,
            "type": "string"
          },
          "role": {
            "type": "string",
            "enum": [
              "LEARNER",
              "MANAGER",
              "ADMINISTRATOR"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "disabled"
            ]
          },
          "createdAt": {
            "type": "string",
            "description": "ISO 8601 date"
          },
          "updatedAt": {
            "type": "string",
            "description": "ISO 8601 date"
          }
        },
        "required": [
          "id",
          "email",
          "firstname",
          "lastname",
          "role",
          "status",
          "createdAt",
          "updatedAt"
        ],
        "additionalProperties": false
      }
    }
  }
}
