Update a course

Update course metadata, access configuration, delivery copy, or publication visibility.

Use access_type: "limited" with access_duration_days to configure time-limited customer access. Switching to lifetime clears the duration. enrollment_limit is optional.

Before changing visibility to PUBLIC, SellApp checks that the course has a ready promotional video and at least one published lesson. If either is missing, the change is rejected.

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.

category?|

Value in

"development" | "business" | "marketing" | "design" | "finance" | "it-software" | "personal-development" | "productivity" | "other" | null

level?string

Value in"all_levels" | "beginner" | "intermediate" | "advanced"

language?string

Lengthlength <= 255

subtitle?|

Lengthlength <= 120

author?|

Lengthlength <= 120

subcategory?|

Lengthlength <= 255

what_you_learn?array<>

Itemsitems <= 50

requirements?array<>

Itemsitems <= 50

certificate_enabled?boolean

access_type?string

Value in"lifetime" | "limited"

access_duration_days?|

Required when access_type is limited; cleared otherwise.

Range1 <= value <= 3650

enrollment_limit?|

Range1 <= value

delivery_text?|

Lengthlength <= 65535

visibility?CatalogVisibility

Value in"PUBLIC" | "ON_HOLD" | "HIDDEN" | "PRIVATE"

expected_updated_at?string

Formatdate-time

Response Body

`application/json`

curl -X PATCH "https://sell.app/api/v2/courses/string" \  -H "X-STORE: launch-lab" \  -H "Content-Type: application/json" \  -d '{    "level": "beginner",    "visibility": "HIDDEN"  }'

{
  "data": {
    "id": 50,
    "title": "Design foundations",
    "slug": "design-foundations",
    "description": "Build your first design with reusable templates.",
    "visibility": "HIDDEN",
    "is_draft": false,
    "delivery_text": "Open your course to get started.",
    "category": "design",
    "level": "beginner",
    "language": "en",
    "subtitle": null,
    "author": "Launch Lab",
    "subcategory": null,
    "what_you_learn": [
      "Customize a reusable template."
    ],
    "requirements": [
      "A web browser."
    ],
    "certificate_enabled": false,
    "access_type": "lifetime",
    "access_duration_days": null,
    "enrollment_limit": null,
    "promo_video": null,
    "sections": [
      {
        "id": 51,
        "title": "Getting started",
        "description": "Your first project.",
        "sort_order": 1,
        "lessons": [
          {
            "id": 52,
            "section_id": 51,
            "title": "Build your first design",
            "content": "Choose a template and add your project details.",
            "type": "lecture",
            "is_preview": false,
            "is_published": false,
            "sort_order": 1,
            "video": null,
            "attachments": [],
            "assignment": null,
            "questions": [],
            "created_at": "2026-09-01T12:00:00Z",
            "updated_at": "2026-09-01T12:00:00Z"
          }
        ],
        "created_at": "2026-09-01T12:00:00Z",
        "updated_at": "2026-09-01T12:00:00Z"
      }
    ],
    "created_at": "2026-09-01T12:00:00Z",
    "updated_at": "2026-09-01T12:00:00Z"
  }
}

{
  "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"
}

Authorization

AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

Use the request body type in TypeScript.

category?|

Value in

"development" | "business" | "marketing" | "design" | "finance" | "it-software" | "personal-development" | "productivity" | "other" | null

level?string

Value in"all_levels" | "beginner" | "intermediate" | "advanced"

language?string

Lengthlength <= 255

subtitle?|

Lengthlength <= 120

author?|

Lengthlength <= 120

subcategory?|

Lengthlength <= 255

what_you_learn?array<>

Itemsitems <= 50

requirements?array<>

Itemsitems <= 50

certificate_enabled?boolean

access_type?string

Value in"lifetime" | "limited"

access_duration_days?|

Required when access_type is limited; cleared otherwise.

Range1 <= value <= 3650

enrollment_limit?|

Range1 <= value

delivery_text?|

Lengthlength <= 65535

visibility?CatalogVisibility

Value in"PUBLIC" | "ON_HOLD" | "HIDDEN" | "PRIVATE"

expected_updated_at?string

Formatdate-time

Response Body

`application/json`

curl -X PUT "https://sell.app/api/v2/courses/string" \  -H "X-STORE: launch-lab" \  -H "Content-Type: application/json" \  -d '{    "level": "beginner",    "visibility": "HIDDEN"  }'

{
  "data": {
    "id": 50,
    "title": "Design foundations",
    "slug": "design-foundations",
    "description": "Build your first design with reusable templates.",
    "visibility": "HIDDEN",
    "is_draft": false,
    "delivery_text": "Open your course to get started.",
    "category": "design",
    "level": "beginner",
    "language": "en",
    "subtitle": null,
    "author": "Launch Lab",
    "subcategory": null,
    "what_you_learn": [
      "Customize a reusable template."
    ],
    "requirements": [
      "A web browser."
    ],
    "certificate_enabled": false,
    "access_type": "lifetime",
    "access_duration_days": null,
    "enrollment_limit": null,
    "promo_video": null,
    "sections": [
      {
        "id": 51,
        "title": "Getting started",
        "description": "Your first project.",
        "sort_order": 1,
        "lessons": [
          {
            "id": 52,
            "section_id": 51,
            "title": "Build your first design",
            "content": "Choose a template and add your project details.",
            "type": "lecture",
            "is_preview": false,
            "is_published": false,
            "sort_order": 1,
            "video": null,
            "attachments": [],
            "assignment": null,
            "questions": [],
            "created_at": "2026-09-01T12:00:00Z",
            "updated_at": "2026-09-01T12:00:00Z"
          }
        ],
        "created_at": "2026-09-01T12:00:00Z",
        "updated_at": "2026-09-01T12:00:00Z"
      }
    ],
    "created_at": "2026-09-01T12:00:00Z",
    "updated_at": "2026-09-01T12:00:00Z"
  }
}

{
  "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"
}

Update a course

200application/json

400application/json

401application/json

403application/json

404application/json

422application/json

429application/json

500application/json

200application/json

400application/json

401application/json

403application/json

404application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`