Skip to content

Import sheet solutions

Use this to import one or more solution files from ChatGPT file parameters or HTTPS URLs for an existing ChalkSurf exercise sheet.

{
"annotations": {
"readOnlyHint": false,
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": true
},
"fileParams": [
"file_id_1",
"file_id_2",
"file_id_3",
"file_id_4",
"file_id_5",
"file_id_6",
"file_id_7",
"file_id_8",
"file_id_9",
"file_id_10",
"file_id_11",
"file_id_12",
"file_id_13",
"file_id_14",
"file_id_15",
"file_id_16",
"file_id_17",
"file_id_18",
"file_id_19",
"file_id_20"
],
"requiredPermission": "write",
"security": {
"type": "oauth2",
"scopes": [
"chalksurf:write"
]
}
}

The server advertises this JSON Schema to MCP clients. Runtime authorization and business-rule checks still apply.

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"exerciseSheetId": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"file_id_1": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_10": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_11": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_12": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_13": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_14": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_15": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_16": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_17": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_18": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_19": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_2": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_20": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_3": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_4": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_5": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_6": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_7": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_8": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"file_id_9": {
"additionalProperties": false,
"description": "A ChatGPT file ID.",
"properties": {
"download_url": {
"format": "uri",
"type": "string"
},
"file_id": {
"minLength": 1,
"type": "string"
},
"file_name": {
"minLength": 1,
"type": "string"
},
"mime_type": {
"minLength": 1,
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"type": "object"
},
"organizationId": {
"description": "The ChalkSurf organization ID to use for this request.",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
},
"sourceUrls": {
"description": "Absolute HTTPS URLs to import. These can be combined with file_id_N upload fields.",
"items": {
"format": "uri",
"type": "string"
},
"maxItems": 20,
"type": "array"
}
},
"required": [
"organizationId",
"exerciseSheetId"
],
"type": "object"
}
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"jobId": {
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"type": "string"
}
},
"required": [
"jobId"
],
"type": "object"
}