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 questions of a quiz
    • postAdd a question to a quiz
    • putReplace the questions of a quiz
    • 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
    Translations
    • getList a course's translations
    • getGet a course translation in one language
    • putSave a course translation in one language
    • patchComplete a course translation
    • delDelete a course translation in one language
    • postPublish a translation
    • postUnpublish a translation
    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}/translations/{language}
    • Parameters
    • JSON body
    • Responses
    • Example

    Translations3 / 7

    • getList a course's translations
    • getGet a course translation in one language
    • putSave a course translation in one language
    • patchComplete a course translation
    • delDelete a course translation in one language
    • postPublish a translation
    • postUnpublish a translation
    1. Instructor API
    2. Translations
    3. Save a course translation in one language

    Save a course translation in one language

    puthttps://mudey.fr/api/v1/courses/{courseId}/translations/{language}courses:write

    Creates or REPLACES the translation for this language. Sections and lessons are referenced by their ID (see the course); an unknown ID is ignored. A published language that no longer passes the checks goes back to draft. publish: true publishes it in the same call.

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

    Parameters

    NameInTypeDescription
    courseId*pathstring
    language*pathfr | en | nlSite language (fr, en or nl), other than the course language.

    JSON body

    Fields marked * are required.

    FieldTypeDescription
    titlestringTranslated title (required).
    subtitlestring | nullTranslated subtitle.
    shortDescriptionstring | nullTranslated tagline.
    descriptionstring | nullTranslated description, in simple HTML (paragraphs, lists, bold, links), cleaned when saved.
    objectivesstring[]What the student will learn, translated.
    requirementsstring[]Translated prerequisites.
    targetAudiencestring[]Target audience, translated.
    welcomeMessagestring | nullTranslated welcome message, plain text: sent with the enrollment confirmation and shown in the player.
    congratulationsMessagestring | nullTranslated congratulations message, plain text: shown to students who complete the course.
    sectionsobjectTranslated sections, by section ID: { "<sectionId>": { "title": "…" } }.
    lessonsobjectTranslated lessons, by lesson ID: { "<lessonId>": { "title": "…", "description": "…" } }.
    publishbooleanPublish the language after saving (complete translation required).

    Responses

    • 200Translation saved.
    • 400Language not available (invalid_language): the course's own language, or not a site language.
    • 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.
    • 409Publication requested but the translation is incomplete (translation_incomplete): `details` lists what is missing.
    • 422Invalid data (details lists the fields).
    • 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 LANGUAGE="..."  # replace me
    
    curl -X PUT "https://mudey.fr/api/v1/courses/$COURSE_ID/translations/$LANGUAGE" \
      -H "Authorization: Bearer $MUDEY_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
      "title": "Learn TypeScript",
      "subtitle": "From the basics to advanced types",
      "description": "<p>From the basics to advanced types, with corrected exercises in every section.</p>",
      "objectives": [
        "Type a React application",
        "Write generic types"
      ],
      "welcomeMessage": "Welcome! Start with the first section, at your own pace.",
      "congratulationsMessage": "Well done, you have completed the course!",
      "sections": {
        "4b2f0c1e-0000-4000-8000-000000000001": {
          "title": "The basics"
        }
      },
      "lessons": {
        "9d1a7e3c-0000-4000-8000-000000000011": {
          "title": "Installing TypeScript"
        },
        "9d1a7e3c-0000-4000-8000-000000000012": {
          "title": "Primitive types"
        }
      },
      "publish": true
    }'
    PreviousGet a course translation in one languageNextComplete a course translation

    © 2026 Mudey · API documentation

    openapi.jsonHelp centerContact