Update a pathway in a curricula version

Partial update of pathway name, type, position, or description. Returns the updated pathway row. Scoped to your integration’s institution via Basic Auth credentials.

PATCH/curricula/{id}/versions/{versionId}/pathways/{pathwayId}

Authorization

AuthorizationBasic auth · headerrequired

Basic Auth with clientId as username and clientSecret as password

Path parameters

idstringrequired

versionIdstringrequired

pathwayIdstringrequired

Request body

requiredapplication/json

namestring

typestring

Allowed:FIXEDSELECTABLE_FOCUS

positioninteger

descriptionstring

Responses

200

Updated pathway

dataCurriculaVersionPathwayrequired

Study pathway within a curricula version. FIXED pathways are mandatory; SELECTABLE_FOCUS pathways let students choose a focus area.

Show properties

idstringrequired

positionintegerrequired

namestringrequired

typestringrequired

FIXED = mandatory pathway; SELECTABLE_FOCUS = student chooses one focus.

Allowed:FIXEDSELECTABLE_FOCUS

curriculaVersionIdstringrequired

descriptionstring | null

metaResponseMetarequired

Show properties

requestIdstringrequired

timestampstring<date-time>required

versionstringrequired

Allowed:v4

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

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*versionIdpath*pathwayIdpath*

Bodyapplication/json

namestringtypestringpositionintegerdescriptionstring

Request

curl -X PATCH 'https://fuxam.app/api/v4/curricula/string/versions/string/pathways/string' \
  -H 'Authorization: Basic YOUR_CREDENTIALS' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Software Engineering track",
  "type": "SELECTABLE_FOCUS",
  "description": "Elective focus area in software engineering."
}'

const response = await fetch("https://fuxam.app/api/v4/curricula/string/versions/string/pathways/string", {
  method: "PATCH",
  headers: {
    "Authorization": "Basic YOUR_CREDENTIALS",
    "Content-Type": "application/json"
  },
  body: "{\n  \"name\": \"Software Engineering track\",\n  \"type\": \"SELECTABLE_FOCUS\",\n  \"description\": \"Elective focus area in software engineering.\"\n}"
});

import requests

response = requests.patch(
    "https://fuxam.app/api/v4/curricula/string/versions/string/pathways/string",
    headers={
        "Authorization": "Basic YOUR_CREDENTIALS",
        "Content-Type": "application/json"
    },
    data="{\n  \"name\": \"Software Engineering track\",\n  \"type\": \"SELECTABLE_FOCUS\",\n  \"description\": \"Elective focus area in software engineering.\"\n}",
)

Response

{
  "data": {
    "id": "path_001",
    "position": 0,
    "name": "Software Engineering",
    "type": "SELECTABLE_FOCUS",
    "curriculaVersionId": "cv_001",
    "description": "Focus on software development."
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-06-26T00: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"
    }
  ]
}