Bulk update content blocks

Updates multiple content blocks in one request. Scoped to your integration’s institution via Basic Auth credentials.

PATCH/content-blocks/bulk

Authorization

AuthorizationBasic auth · headerrequired

Basic Auth with clientId as username and clientSecret as password

Request body

requiredapplication/json

One of:

object

updatesBulkUpdateContentBlockItem[]required

min items 1 · max items 100

Show properties

Array of BulkUpdateContentBlockItem

idstringrequired

namestring

min length 1 · max length 100

descriptionstring

max length 10000

statusstring

Allowed:PUBLISHEDCOMING_SOONDRAFTDISABLED

positioninteger

min 0

dueDatestring<date-time> | null

startDatestring<date-time> | null

expectedLearnTimeMinutesinteger | null

min 1

object

idsstring[]required

min items 1 · max items 100

updateobjectrequired

Show properties

namestring

min length 1 · max length 100

descriptionstring

max length 10000

statusstring

Allowed:PUBLISHEDCOMING_SOONDRAFTDISABLED

dueDatestring<date-time> | null

startDatestring<date-time> | null

expectedLearnTimeMinutesinteger | null

min 1

Responses

200

Content blocks updated

dataBulkUpdateContentBlocksResultrequired

Show properties

updatedobject[]required

Show properties

Array of object

idstringrequired

namestringrequired

statusstringrequired

countintegerrequired

conflictsPositionConflict[]required

Show properties

Array of PositionConflict

blockIdstringrequired

blockNamestringrequired

conditionIdstringrequired

requiredBlockIdstringrequired

requiredBlockNamestringrequired

messagestringrequired

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

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

Bodyapplication/json

Request body

Request

curl -X PATCH 'https://fuxam.app/api/v4/content-blocks/bulk' \
  -H 'Authorization: Basic YOUR_CREDENTIALS' \
  -H 'Content-Type: application/json' \
  -d '{
  "updates": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "status": "PUBLISHED",
      "position": 0,
      "dueDate": "2019-08-24T14:15:22Z",
      "startDate": "2019-08-24T14:15:22Z",
      "expectedLearnTimeMinutes": 1
    }
  ]
}'

const response = await fetch("https://fuxam.app/api/v4/content-blocks/bulk", {
  method: "PATCH",
  headers: {
    "Authorization": "Basic YOUR_CREDENTIALS",
    "Content-Type": "application/json"
  },
  body: "{\n  \"updates\": [\n    {\n      \"id\": \"string\",\n      \"name\": \"string\",\n      \"description\": \"string\",\n      \"status\": \"PUBLISHED\",\n      \"position\": 0,\n      \"dueDate\": \"2019-08-24T14:15:22Z\",\n      \"startDate\": \"2019-08-24T14:15:22Z\",\n      \"expectedLearnTimeMinutes\": 1\n    }\n  ]\n}"
});

import requests

response = requests.patch(
    "https://fuxam.app/api/v4/content-blocks/bulk",
    headers={
        "Authorization": "Basic YOUR_CREDENTIALS",
        "Content-Type": "application/json"
    },
    data="{\n  \"updates\": [\n    {\n      \"id\": \"string\",\n      \"name\": \"string\",\n      \"description\": \"string\",\n      \"status\": \"PUBLISHED\",\n      \"position\": 0,\n      \"dueDate\": \"2019-08-24T14:15:22Z\",\n      \"startDate\": \"2019-08-24T14:15:22Z\",\n      \"expectedLearnTimeMinutes\": 1\n    }\n  ]\n}",
)

Response

{
  "data": {
    "updated": [
      {
        "id": "string",
        "name": "string",
        "status": "string"
      }
    ],
    "count": 0,
    "conflicts": [
      {
        "blockId": "string",
        "blockName": "string",
        "conditionId": "string",
        "requiredBlockId": "string",
        "requiredBlockName": "string",
        "message": "string"
      }
    ]
  },
  "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"
    }
  ]
}