MudeyMudeyAPI documentation
    OpenAPIMy keysBack to Mudey

    Guide

    • Overview
    • Getting started
    • Publishing a course
    • Errors
    • Security
    Account
    • getAccount and key permissions
    • getCatalog categories
    Courses
    • getList my courses
    • postCreate a course
    • getGet a full course
    • patchUpdate a course
    • delDelete a course
    • postPublish
    • postUnpublish
    Modules
    • postAdd a module
    • putReorder modules
    • patchUpdate a module
    • delDelete a module
    Lessons
    • postAdd a lesson
    • putReorder the lessons of a module
    • getGet a lesson
    • patchUpdate a lesson
    • delDelete a lesson
    • getList the transcripts of a lesson
    • getGet the transcript of a lesson in a language
    • putUpload the transcript of a lesson in a language
    • delDelete the transcript of a lesson in a language
    Files
    • postGet an upload URL
    Coupons
    • getList my coupons
    • postCreate a coupon
    • getGet a coupon
    • patchUpdate a coupon
    • delDelete a coupon
    Students and revenue
    • getStudents of a course
    • getStatistics of a course
    • getStatistics of all my courses
    • getRevenue for a month

    On this page

    PUT /courses/{courseId}/lessons/{lessonId}/transcripts/{language}
    • Parameters
    • JSON body
    • Responses
    • Example

    Lessons8 / 9

    • postAdd a lesson
    • putReorder the lessons of a module
    • getGet a lesson
    • patchUpdate a lesson
    • delDelete a lesson
    • getList the transcripts of a lesson
    • getGet the transcript of a lesson in a language
    • putUpload the transcript of a lesson in a language
    • delDelete the transcript of a lesson in a language
    1. Instructor API
    2. Lessons
    3. Upload the transcript of a lesson in a language

    Upload the transcript of a lesson in a language

    puthttps://mudey.fr/api/v1/courses/{courseId}/lessons/{lessonId}/transcripts/{language}courses:write

    Content of a .vtt or .srt file, or plain text (txt). Text where every line starts with a timestamp "[01:23]" keeps its timing. Replaces the transcript for this language, including an automatic transcript; visible to students immediately. isOriginal (default: the course language) marks the language spoken in the video, one per lesson.

    Authorization: Bearer mudey_sk_… header required. Create and use a key

    Parameters

    NameInTypeDescription
    courseId*pathstring
    lessonId*pathstring
    language*pathstringISO 639-1 language code (fr, en, nl, de, es…).

    JSON body

    Fields marked * are required.

    FieldTypeDescription
    formatvtt | srt | txtContent format; txt by default.
    content*stringFile content, or text. 2 MB at most, 400,000 characters of text kept.
    isOriginalbooleanLanguage spoken in the video. Default: true if it is the course language.

    Responses

    • 200Transcript saved.
    • 401Missing, invalid, revoked or expired key.
    • 403Missing permission on the key, or the account is no longer an instructor.
    • 404Resource not found among your courses.
    • 409Lesson linked to another course (mirrored_lesson).
    • 422Unsupported language (invalid_language), unreadable file (invalid_transcript) or not a video lesson (not_video_lesson).
    • 429Rate limit exceeded (300 calls per minute per key). See the Retry-After header.

    Example

    export MUDEY_API_KEY="mudey_sk_..."
    export COURSE_ID="..."  # replace me
    export LESSON_ID="..."  # replace me
    export LANGUAGE="..."  # replace me
    
    curl -X PUT "https://mudey.fr/api/v1/courses/$COURSE_ID/lessons/$LESSON_ID/transcripts/$LANGUAGE" \
      -H "Authorization: Bearer $MUDEY_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
      "format": "srt",
      "content": "1\n00:00:00,000 --> 00:00:04,200\nBonjour et bienvenue dans cette formation.\n\n2\n00:00:04,200 --> 00:00:08,000\nOn commence par installer TypeScript.\n"
    }'
    PreviousGet the transcript of a lesson in a languageNextDelete the transcript of a lesson in a language

    © 2026 Mudey · API documentation

    openapi.jsonHelp centerContact