API ReferenceCourses

Reorder course lessons

Set the complete lesson order and choose each lesson's section.

Send every lesson ID exactly once with a section_id from the same course. Entries appear in request order within each destination section. An invalid list returns 422 without changing any positions.

PATCH
/v2/courses/{course}/lessons/reorder

Authorization

AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

Path Parameters

course*string

The course path parameter.

Header Parameters

X-STORE?string

Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://sell.app/api/v2/courses/string/lessons/reorder" \  -H "X-STORE: launch-lab" \  -H "Content-Type: application/json" \  -d '{    "resources": [      {        "id": 601,        "section_id": 501      },      {        "id": 602,        "section_id": 501      }    ]  }'
{
  "data": {
    "id": 0,
    "title": "string",
    "slug": "string",
    "description": "string",
    "visibility": "PUBLIC",
    "is_draft": true,
    "delivery_text": "string",
    "category": "development",
    "level": "all_levels",
    "language": "string",
    "subtitle": "string",
    "author": "string",
    "subcategory": "string",
    "what_you_learn": [
      "string"
    ],
    "requirements": [
      "string"
    ],
    "certificate_enabled": true,
    "access_type": "lifetime",
    "access_duration_days": 1,
    "enrollment_limit": 1,
    "promo_video": {
      "mux_playback_id": "string",
      "mux_status": "string",
      "duration_seconds": 0
    },
    "sections": [
      {
        "id": 1,
        "title": "Getting started",
        "description": null,
        "sort_order": 1,
        "lessons": [
          {
            "id": 1,
            "section_id": 1,
            "title": "Welcome to the reading room",
            "content": "Read the first founder memo.",
            "type": "lecture",
            "is_preview": false,
            "is_published": false,
            "sort_order": 1,
            "video": null,
            "attachments": [],
            "assignment": null,
            "questions": [],
            "created_at": "2026-08-30T12:00:01.000000Z",
            "updated_at": "2026-08-30T12:00:01.000000Z"
          }
        ],
        "created_at": "2026-08-30T12:00:01.000000Z",
        "updated_at": "2026-08-30T12:00:01.000000Z"
      }
    ],
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}
{
  "type": "invalid_request_error",
  "code": "bad_request",
  "message": "The request could not be understood.",
  "status": 400,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#bad-request"
}
{
  "type": "authentication_error",
  "code": "unauthenticated",
  "message": "Unauthenticated.",
  "status": 401,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#unauthenticated"
}
{
  "type": "authorization_error",
  "code": "forbidden",
  "message": "This action is unauthorized.",
  "status": 403,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#forbidden"
}
{
  "type": "not_found_error",
  "code": "resource_not_found",
  "message": "Not Found.",
  "status": 404,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#resource-not-found"
}
{
  "type": "validation_error",
  "code": "validation_failed",
  "message": "The selected product variant id is invalid.",
  "status": 422,
  "param": "product_variant_id",
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#validation-failed",
  "errors": {
    "product_variant_id": [
      "The selected product variant id is invalid."
    ]
  }
}
{
  "type": "rate_limit_error",
  "code": "rate_limit_exceeded",
  "message": "Too Many Attempts.",
  "status": 429,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#rate-limit-exceeded"
}
{
  "type": "api_error",
  "code": "api_error",
  "message": "Server Error",
  "status": 500,
  "param": null,
  "request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
  "docs_url": "https://sell.app/docs/api/errors#api-error"
}