Bulk create content blocks
Creates multiple content blocks in one request. Scoped to your integration’s institution via Basic Auth credentials.
POST
/content-blocks/bulkHeader parameters
Idempotency-KeystringrequiredUnique key to ensure idempotent creation
Request body
requiredapplication/jsoncourseIdstringrequiredLayer ID of the course. Required.
contentBlocksBulkCreateContentBlockItem[]requiredmin items 1 · max items 50
Show propertiesHide properties
Array of
BulkCreateContentBlockItemnamestringrequiredmin length 1 · max length 100
descriptionstringmax length 10000
typestringrequiredAllowed:
TextImageVideoTestInteractiveFileLinkHandInCertificateExternalDeliverableSurveySectionstatusstringAllowed:
PUBLISHEDCOMING_SOONDRAFTDISABLEDpositionintegermin 0
dueDatestring<date-time>startDatestring<date-time>specsobjectexpectedLearnTimeMinutesintegermin 1
isDependentbooleanautoPositionbooleandefault: false
Responses
201Content blocks created
dataBulkCreateContentBlocksResultrequiredShow propertiesHide properties
createdobject[]requiredShow propertiesHide properties
Array of
objectidstringrequirednamestringrequiredpositionintegerrequiredcountintegerrequiredpositionWarningsobject[]requiredShow propertiesHide properties
Array of
objectmessagestringrequiredaffectedConditionIdstringrequiredmetaResponseMetarequiredShow propertiesHide properties
requestIdstringrequiredtimestampstring<date-time>requiredversionstringrequiredAllowed:
v4400Bad Request
typestringrequiredAllowed:
errorcodestringrequiredAllowed:
bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_errortitlestringrequiredstatusintegerrequireddetailstringrequiredinstancestringerrorsobject[]Show propertiesHide properties
Array of
objectfieldstringmessagestring401Unauthorized
typestringrequiredAllowed:
errorcodestringrequiredAllowed:
bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_errortitlestringrequiredstatusintegerrequireddetailstringrequiredinstancestringerrorsobject[]Show propertiesHide properties
Array of
objectfieldstringmessagestring403Forbidden
typestringrequiredAllowed:
errorcodestringrequiredAllowed:
bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_errortitlestringrequiredstatusintegerrequireddetailstringrequiredinstancestringerrorsobject[]Show propertiesHide properties
Array of
objectfieldstringmessagestring409Conflict
typestringrequiredAllowed:
errorcodestringrequiredAllowed:
bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_errortitlestringrequiredstatusintegerrequireddetailstringrequiredinstancestringerrorsobject[]Show propertiesHide properties
Array of
objectfieldstringmessagestring429Too Many Requests
typestringrequiredAllowed:
errorcodestringrequiredAllowed:
bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_errortitlestringrequiredstatusintegerrequireddetailstringrequiredinstancestringerrorsobject[]Show propertiesHide properties
Array of
objectfieldstringmessagestring500Internal Server Error
typestringrequiredAllowed:
errorcodestringrequiredAllowed:
bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_errortitlestringrequiredstatusintegerrequireddetailstringrequiredinstancestringerrorsobject[]Show propertiesHide properties
Array of
objectfieldstringmessagestringRequest
curl -X POST "https://fuxam.app/api/v4/content-blocks/bulk" \
-H "Idempotency-Key: string" \
-H "Content-Type: application/json" \
-d '{
"courseId": "string",
"contentBlocks": [
{
"name": "string",
"description": "string",
"type": "Text",
"status": "PUBLISHED",
"position": 0,
"dueDate": "2024-01-01T00:00:00Z",
"startDate": "2024-01-01T00:00:00Z",
"specs": {},
"expectedLearnTimeMinutes": 0,
"isDependent": true
}
],
"autoPosition": false
}'const response = await fetch("https://fuxam.app/api/v4/content-blocks/bulk", {
method: "POST",
headers: {
"Idempotency-Key": "string",
"Content-Type": "application/json"
},
body: JSON.stringify({
"courseId": "string",
"contentBlocks": [
{
"name": "string",
"description": "string",
"type": "Text",
"status": "PUBLISHED",
"position": 0,
"dueDate": "2024-01-01T00:00:00Z",
"startDate": "2024-01-01T00:00:00Z",
"specs": {},
"expectedLearnTimeMinutes": 0,
"isDependent": true
}
],
"autoPosition": false
})
});import requests
response = requests.post(
"https://fuxam.app/api/v4/content-blocks/bulk",
headers={
"Idempotency-Key": "string",
"Content-Type": "application/json"
},
json={
"courseId": "string",
"contentBlocks": [
{
"name": "string",
"description": "string",
"type": "Text",
"status": "PUBLISHED",
"position": 0,
"dueDate": "2024-01-01T00:00:00Z",
"startDate": "2024-01-01T00:00:00Z",
"specs": {},
"expectedLearnTimeMinutes": 0,
"isDependent": True
}
],
"autoPosition": False
},
)Response
{
"data": {
"created": [
{
"id": "string",
"name": "string",
"position": 0
}
],
"count": 0,
"positionWarnings": [
{
"message": "string",
"affectedConditionId": "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"
}
]
}{
"type": "error",
"code": "resource_not_found",
"title": "Not Found",
"status": 404,
"detail": "Course not found",
"instance": "req_1234567890_abc",
"errors": [
{
"field": "string",
"message": "string"
}
]
}