Update a course

Partially updates course metadata, status, and tags. At least one field is required. Scoped to your integration’s institution via Basic Auth credentials.

PATCH/courses/{id}

Authorization

AuthorizationBasic auth · headerrequired

Basic Auth with clientId as username and clientSecret as password

Path parameters

idstringrequired

Course ID

Request body

requiredapplication/json

codestring

min length 1 · max length 100

namestring

min length 1 · max length 255

descriptionstring

max length 5000

iconstring

iconTypestring

Allowed:imageemoji

colorinteger

min 0 · max 23

bannerImagestring

capacityinteger

min 1

statusstring

Allowed:ACTIVEARCHIVED

tagIdsstring[]

Responses

200

Updated course

dataCourserequired

Show properties

idstringrequired

codestring | nullrequired

namestringrequired

descriptionstring | null

iconstringrequired

iconTypestringrequired

Allowed:imageemoji

colorintegerrequired

min 0 · max 23

bannerImagestring | null

capacityinteger | null

statusstringrequired

Allowed:ACTIVEARCHIVED

isDatabasebooleanrequired

layerIdstringrequired

institutionIdstringrequired

tagsCourseTag[]required

Show properties

Array of CourseTag

idstringrequired

namestringrequired

colorstring | null

iconstring | null

metaResponseMetarequired

Show properties

requestIdstringrequired

timestampstring<date-time>required

versionstringrequired

Allowed:v4

400

Bad Request

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

401

Unauthorized

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

403

Forbidden

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

404

Not Found

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

429

Too Many Requests

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

500

Internal Server Error

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Basic auth usernameBasic auth password

Remember on this deviceInclude my values in samples

Parameters

idpath*Course ID

Bodyapplication/json

Request body

Request

curl -X PATCH 'https://fuxam.app/api/v4/courses/string' \
  -H 'Authorization: Basic YOUR_CREDENTIALS' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Introduction to Biology",
  "description": "Updated course description",
  "status": "ACTIVE",
  "iconType": "emoji",
  "icon": "🧬",
  "color": 5,
  "capacity": 120,
  "tagIds": [
    "science",
    "biology"
  ]
}'

const response = await fetch("https://fuxam.app/api/v4/courses/string", {
  method: "PATCH",
  headers: {
    "Authorization": "Basic YOUR_CREDENTIALS",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"Introduction to Biology\",\n  \"description\": \"Updated course description\",\n  \"status\": \"ACTIVE\",\n  \"iconType\": \"emoji\",\n  \"icon\": \"🧬\",\n  \"color\": 5,\n  \"capacity\": 120,\n  \"tagIds\": [\n    \"science\",\n    \"biology\"\n  ]\n}"
});

import requests

response = requests.patch(
    "https://fuxam.app/api/v4/courses/string",
    headers={
        "Authorization": "Basic YOUR_CREDENTIALS",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"Introduction to Biology\",\n  \"description\": \"Updated course description\",\n  \"status\": \"ACTIVE\",\n  \"iconType\": \"emoji\",\n  \"icon\": \"🧬\",\n  \"color\": 5,\n  \"capacity\": 120,\n  \"tagIds\": [\n    \"science\",\n    \"biology\"\n  ]\n}",
)

Response

{
  "data": {
    "id": "cmh1cg59i002914ia01lve3i5",
    "code": "CS101",
    "name": "Introduction to Computer Science",
    "description": "An introductory course to computer science fundamentals",
    "icon": "/illustrations/course-icon-library/book-worm.webp",
    "iconType": "image",
    "color": 5,
    "bannerImage": "https://example.com/banner.jpg",
    "capacity": 50,
    "status": "ACTIVE",
    "isDatabase": false,
    "layerId": "layer_abc123",
    "institutionId": "inst_xyz789",
    "tags": [
      {
        "id": "tag_abc123",
        "name": "Mathematics",
        "color": "#FF5733",
        "icon": "🔢"
      }
    ]
  },
  "meta": {
    "requestId": "req_1234567890_abc",
    "timestamp": "2026-06-02T07:00:00.000Z",
    "version": "v4"
  }
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}