> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.sessionboard.com/llms.txt > Use this file to discover all available pages before exploring further. # Draft a course from videos > Starts making a course from 1–10 videos or clips. The videos are checked now (same organization, a transcript, no cuts); then the course is generated in the background: lesson-sized segments, a clip cut for each, and per lesson a short reading, in-video questions and a quiz, every question grounded in that clip's transcript. Answers `202` with the draft (`status: queued`); poll `GET /v1/organization/{orgId}/learning/drafts/{draftId}` until `status` is `ready` or `failed` (usually a minute or two per video). Nothing is published and no one is notified. Requires `write:learning`. Also at `POST /v1/learning/drafts/create`. ## OpenAPI ````yaml /api-reference/openapi.yaml post /v1/organization/{orgId}/learning/drafts/create openapi: 3.1.0 info: title: Sessionboard Public API version: '1.0' description: >- REST API for managing sessions, speakers, contacts, sponsors, exhibitors, and event data on the Sessionboard platform. contact: name: Sessionboard Support email: support@sessionboard.com termsOfService: https://www.sessionboard.com/legal/terms-of-service servers: - url: https://public-api.sessionboard.com description: US Region - url: https://public-api-eu.sessionboard.com description: EU Region security: - ApiKey: [] - BearerToken: [] tags: - name: Events description: Manage events on the platform. - name: Sessions description: Search and retrieve sessions within an event. - name: Session Writes description: >- Create, update, delete, and restore sessions. Requires the `write:sessions` scope. - name: Contact Writes description: >- Create, update, delete, and restore contacts. Requires the `write:contacts` scope. - name: Exhibitor Writes description: >- Create, update, delete, and restore exhibitors. Requires the `write:exhibitors` scope. - name: Sponsor Writes description: >- Create, update, delete, and restore sponsors. Requires the `write:sponsors` scope. - name: Field Writes description: >- Create, update, and delete custom fields. Requires the `write:fields` scope. - name: Speakers description: Search and retrieve speakers within an event. - name: Participants description: | Search and retrieve every contact holding a session role on an event — speakers, chairpersons, moderators and custom roles — with the roles each one holds, and list the event's participant roles. - name: Contacts description: Search and retrieve contacts at the organization or event level. - name: Sponsors description: Search and retrieve sponsors within an event. - name: Exhibitors description: Search and retrieve exhibitors within an event. - name: Event Settings description: >- Retrieve event configuration such as fields, tags, tracks, rooms, formats, levels, languages, and session statuses. - name: GDPR description: Manage GDPR data access and erasure requests. - name: Insights description: >- Query event data using SbQL, generate queries with AI, and manage dashboards. - name: Ask description: >- Ask a natural-language question about one event and get a cited answer. Requires the `read:ask` scope, granted explicitly. - name: Metadata Writes description: >- Create, update, and delete session metadata (rooms, tracks, tags, formats, levels, languages, statuses). Requires the `write:metadata` scope. - name: Agenda Planning description: >- Manage agenda drafts, draft sessions, scheduling rules, and evaluation personas. Requires the `write:events` scope. - name: Dashboards & Widgets description: >- Create, read, update, and delete dashboards and widgets at the event or organization level. Requires `write:events` scope for writes. - name: Reports & Queries description: >- Create, read, update, delete, and run saved SbQL queries/reports at the event or organization level. Requires `write:events` scope for writes. - name: Transcriptions description: >- Transcript text on sessions — fragments, summaries, insights, and translations. Requires `read:transcriptions` / `write:transcriptions` scopes. - name: Session Recordings description: >- Session audio files for recording archives (live capture or imported audio). Requires `read:transcriptions` / `write:transcriptions` scopes. - name: Media description: >- Upload video or audio files for automatic transcription. Requires `read:media` / `write:media` scopes. - name: Session Files description: > Documents attached to sessions (PDFs, PowerPoint, Word, images, and similar). Simple upload: `POST .../files/upload` (multipart, max 50 MB). Direct-to-storage: create → PUT → complete (max 500 MB). Requires `read:sessions` / `write:sessions` scopes. See the [Uploading session files](/guides/uploading-session-files) guide. - name: OAuth description: >- OAuth 2.1 endpoints for AI client authorization (Claude, ChatGPT). Mounted at `/oauth/` (not `/v1/`). - name: Log Export description: > Pull your organization's API request, security and audit logs into a SIEM such as Splunk, Microsoft Sentinel or Elastic. Requires a dedicated API token with the `read:audit_logs` scope, which can call nothing else. See the [Exporting logs to a SIEM](/guides/exporting-logs-to-a-siem) guide. - name: Awards description: >- Read and manage Awards programs and their categories, rounds, promo codes, submissions and reviews. Organization-level: paths start at `/v1/organization/{orgId}/awards`. Requires `read:awards` / `write:awards` scopes. - name: Registration description: > Registration inside Sessionboard: registration forms, ticket types, registrations, orders, attendees and check-ins for one event. Requires the preview scopes `read:registrations` / `write:registrations`, which a token or OAuth client gets only when they are named explicitly (not by default, and not listed in `scopes_supported`). The event must have Registration turned on (Early Access); otherwise every endpoint answers `403 FORBIDDEN`. See the [Registration and Expo](/guides/registration-and-expo) guide. - name: Expo description: > Expo floor-map booths and sponsorship inventory for one event. Requires the preview scopes `read:expo` / `write:expo`, which a token or OAuth client gets only when they are named explicitly (not by default, and not listed in `scopes_supported`). The event must have Expo turned on (Early Access); otherwise every endpoint answers `403 FORBIDDEN`. See the [Registration and Expo](/guides/registration-and-expo) guide. - name: Learning description: > Turn Media-section videos (webinars, recordings, uploads, clips) into a course: draft it from videos, review and edit the draft, then publish it and assign it. Organization-level: paths start at `/v1/organization/{orgId}/learning`, and the same operations are served under `/v1/learning` with the organization taken from the token. Requires the preview scopes `read:learning` / `write:learning`, which a token or OAuth client gets only when they are named explicitly (not by default, and not listed in `scopes_supported`). The organization must have Learning turned on, and the token's user needs the Lessons permissions. paths: /v1/organization/{orgId}/learning/drafts/create: post: tags: - Learning summary: Draft a course from videos description: >- Starts making a course from 1–10 videos or clips. The videos are checked now (same organization, a transcript, no cuts); then the course is generated in the background: lesson-sized segments, a clip cut for each, and per lesson a short reading, in-video questions and a quiz, every question grounded in that clip's transcript. Answers `202` with the draft (`status: queued`); poll `GET /v1/organization/{orgId}/learning/drafts/{draftId}` until `status` is `ready` or `failed` (usually a minute or two per video). Nothing is published and no one is notified. Requires `write:learning`. Also at `POST /v1/learning/drafts/create`. operationId: create-course-draft parameters: - $ref: '#/components/parameters/LearningOrgId' requestBody: required: true content: application/json: schema: type: object required: - mediaItemIds properties: mediaItemIds: type: array minItems: 1 maxItems: 10 items: type: string format: uuid description: Videos / clips from List videos, in course order. title: type: string maxLength: 255 description: >- Course title. Defaults to the video's title when there is one video. audience: type: string maxLength: 500 description: >- Who the course is for. Shapes the writing; it does not decide who is assigned. certification: type: boolean description: Add a certification earned by completing every lesson. validityMonths: type: integer minimum: 1 maximum: 120 description: How long the certification lasts. Omit for never expires. questionTypes: type: array items: type: string enum: - multiple_choice - true_false - short_answer - multi_select - ordering - matching - numeric description: Default `multiple_choice`, `true_false`, `multi_select`. checkpointsPerLesson: type: integer minimum: 0 maximum: 3 description: Questions that pause the video, per lesson. Default 2. quizQuestions: type: integer minimum: 1 maximum: 10 description: Final quiz questions per lesson. Default 4. maxLessonsPerVideo: type: integer minimum: 1 maximum: 12 description: >- Upper bound on lessons from one long video, default 8. Exceeded only when fewer lessons would each run past 10 minutes. responses: '202': description: Queued. content: application/json: schema: type: object properties: payload: type: object properties: draft: $ref: '#/components/schemas/CourseDraftSummary' poll: type: string description: >- Internal path of the draft; poll the Get a course draft operation. '400': description: A video is not in this organization, has no transcript, or has cuts. '403': $ref: '#/components/responses/LearningForbidden' components: parameters: LearningOrgId: name: orgId in: path required: true schema: type: string description: Your organization ID. Any other organization returns `404`. schemas: CourseDraftSummary: type: object properties: id: type: string format: uuid status: type: string enum: - queued - generating - ready - applying - applied - failed title: type: - string - 'null' media_item_ids: type: array items: type: string format: uuid progress: type: - object - 'null' properties: step: type: string done: type: integer total: type: integer error: type: - string - 'null' lesson_count: type: integer applied_at: type: - string - 'null' format: date-time created_at: type: string format: date-time updated_at: type: string format: date-time description: Send back as `baseUpdatedAt` when you save. responses: LearningForbidden: description: > - `SCOPE_REQUIRED` — the token lacks `read:learning` (reads) or `write:learning` (writes). Legacy tokens with no scopes cannot write. - `FORBIDDEN` — Learning is not on for the organization, or the token's user lacks the Lessons permission. securitySchemes: ApiKey: type: apiKey in: header name: x-access-token description: >- Organization API token. Generate from Organization Settings → API Tokens. BearerToken: type: http scheme: bearer description: >- OAuth 2.1 access token. Obtained via the OAuth PKCE flow at `/oauth/token`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.