Reorder content blocks in a course

Reorders content blocks within a course. Scoped to your integration’s institution via Basic Auth credentials.

PUT/courses/{id}/content-blocks/reorder

Authorization

AuthorizationBasic auth · headerrequired

Basic Auth with clientId as username and clientSecret as password

Path parameters

idstringrequired

Course ID (layer ID of the course)

Request body

requiredapplication/json

positionsobject[]required

min items 1

Show properties

Array of object

idstringrequired

Content block ID

positionintegerrequired

New position for the block

min 0

resolveConflictsboolean

default: false

Responses

200

Content blocks reordered

dataReorderContentBlocksResultrequired

Show properties

updatedobject[]required

Show properties

Array of object

idstringrequired

positionintegerrequired

previousPositionintegerrequired

conflictsobject[]required

Show properties

Array of object

blockIdstringrequired

blockNamestringrequired

conditionIdstringrequired

requiredBlockIdstringrequired

requiredBlockNamestringrequired

typestringrequired

Allowed:DEPENDENCY_VIOLATION

messagestringrequired

resolvedboolean

conflictsResolvedbooleanrequired

deletedConditionIdsstring[]

Present when conflicts were auto-resolved via resolveConflicts.

metaResponseMetarequired

Show properties

requestIdstringrequired

timestampstring<date-time>required

versionstringrequired

Allowed:v4

watermarkstring<date-time>

Present on GET /users?updatedSince= pages. Taken at the first page minus a 60s overlap. Bound into pagination.next_cursor. Use it as the next updatedSince after deduping by user id. Delivery is inclusive >= and at-least-once.

400

Bad Request

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedidempotency_key_in_progressservice_unavailableretryablerate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

existingUserIdstring

Present on 409 email or membership-code conflicts. The user id that already holds the email or code.

activeSessionobject

Present on time-tracking start 409 when a session is already running. Stop this session, then retry start.

Show properties

idstringrequired

startTimestring<date-time>required

conflictingLogobject

Present on time-tracking 409 when the interval being written overlaps an existing log or open session. Start uses [punch, ∞). Stop uses [sessionStart, stop). endTime is null while that session is still open.

Show properties

idstringrequired

startTimestring<date-time>required

endTimestring<date-time> | nullrequired

401

Unauthorized

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedidempotency_key_in_progressservice_unavailableretryablerate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

existingUserIdstring

Present on 409 email or membership-code conflicts. The user id that already holds the email or code.

activeSessionobject

Present on time-tracking start 409 when a session is already running. Stop this session, then retry start.

Show properties

idstringrequired

startTimestring<date-time>required

conflictingLogobject

Show properties

idstringrequired

startTimestring<date-time>required

endTimestring<date-time> | nullrequired

403

Forbidden

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedidempotency_key_in_progressservice_unavailableretryablerate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

existingUserIdstring

Present on 409 email or membership-code conflicts. The user id that already holds the email or code.

activeSessionobject

Present on time-tracking start 409 when a session is already running. Stop this session, then retry start.

Show properties

idstringrequired

startTimestring<date-time>required

conflictingLogobject

Show properties

idstringrequired

startTimestring<date-time>required

endTimestring<date-time> | nullrequired

404

Not Found

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedidempotency_key_in_progressservice_unavailableretryablerate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

existingUserIdstring

Present on 409 email or membership-code conflicts. The user id that already holds the email or code.

activeSessionobject

Present on time-tracking start 409 when a session is already running. Stop this session, then retry start.

Show properties

idstringrequired

startTimestring<date-time>required

conflictingLogobject

Show properties

idstringrequired

startTimestring<date-time>required

endTimestring<date-time> | nullrequired

429

Too Many Requests — 1000 requests per minute per institution. Includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (ISO-8601), and Retry-After (seconds).

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedidempotency_key_in_progressservice_unavailableretryablerate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

existingUserIdstring

Present on 409 email or membership-code conflicts. The user id that already holds the email or code.

activeSessionobject

Present on time-tracking start 409 when a session is already running. Stop this session, then retry start.

Show properties

idstringrequired

startTimestring<date-time>required

conflictingLogobject

Show properties

idstringrequired

startTimestring<date-time>required

endTimestring<date-time> | nullrequired

500

Internal Server Error

typestringrequired

Allowed:error

codestringrequired

Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedidempotency_key_in_progressservice_unavailableretryablerate_limit_exceededinternal_error

titlestringrequired

statusintegerrequired

detailstringrequired

instancestring

errorsobject[]

Show properties

Array of object

fieldstring

messagestring

existingUserIdstring

Present on 409 email or membership-code conflicts. The user id that already holds the email or code.

activeSessionobject

Present on time-tracking start 409 when a session is already running. Stop this session, then retry start.

Show properties

idstringrequired

startTimestring<date-time>required

conflictingLogobject

Show properties

idstringrequired

startTimestring<date-time>required

endTimestring<date-time> | nullrequired

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 (layer ID of the course)

Bodyapplication/json

Request body

Request

curl -X PUT 'https://fuxam.app/api/v4/courses/string/content-blocks/reorder' \
  -H 'Authorization: Basic YOUR_CREDENTIALS' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "positions": [
    {
      "id": "string",
      "position": 0
    }
  ],
  "resolveConflicts": false
}'

const response = await fetch("https://fuxam.app/api/v4/courses/string/content-blocks/reorder", {
  method: "PUT",
  headers: {
    "Authorization": "Basic YOUR_CREDENTIALS",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"positions\": [\n    {\n      \"id\": \"string\",\n      \"position\": 0\n    }\n  ],\n  \"resolveConflicts\": false\n}"
});

import requests

response = requests.put(
    "https://fuxam.app/api/v4/courses/string/content-blocks/reorder",
    headers={
        "Authorization": "Basic YOUR_CREDENTIALS",
        "Accept": "application/json",
        "Content-Type": "application/json"
    },
    data="{\n  \"positions\": [\n    {\n      \"id\": \"string\",\n      \"position\": 0\n    }\n  ],\n  \"resolveConflicts\": false\n}",
)

Response

{
  "data": {
    "updated": [
      {
        "id": "string",
        "position": 0,
        "previousPosition": 0
      }
    ],
    "conflicts": [
      {
        "blockId": "string",
        "blockName": "string",
        "conditionId": "string",
        "requiredBlockId": "string",
        "requiredBlockName": "string",
        "type": "DEPENDENCY_VIOLATION",
        "message": "string",
        "resolved": true
      }
    ],
    "conflictsResolved": true,
    "deletedConditionIds": [
      "string"
    ]
  },
  "meta": {
    "requestId": "req_1234567890_abc",
    "timestamp": "2026-06-02T07:00:00.000Z",
    "version": "v4",
    "watermark": "2019-08-24T14:15:22Z"
  }
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "existingUserId": "string",
  "activeSession": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z"
  },
  "conflictingLog": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z",
    "endTime": "2019-08-24T14:15:22Z"
  }
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "existingUserId": "string",
  "activeSession": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z"
  },
  "conflictingLog": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z",
    "endTime": "2019-08-24T14:15:22Z"
  }
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "existingUserId": "string",
  "activeSession": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z"
  },
  "conflictingLog": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z",
    "endTime": "2019-08-24T14:15:22Z"
  }
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "existingUserId": "string",
  "activeSession": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z"
  },
  "conflictingLog": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z",
    "endTime": "2019-08-24T14:15:22Z"
  }
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "existingUserId": "string",
  "activeSession": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z"
  },
  "conflictingLog": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z",
    "endTime": "2019-08-24T14:15:22Z"
  }
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ],
  "existingUserId": "string",
  "activeSession": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z"
  },
  "conflictingLog": {
    "id": "string",
    "startTime": "2019-08-24T14:15:22Z",
    "endTime": "2019-08-24T14:15:22Z"
  }
}