Import exercise
import_exercise
Section titled “import_exercise”Use this to import one or more exercise source files from ChatGPT file parameters or HTTPS URLs into a ChalkSurf organization.
Contract metadata
Section titled “Contract metadata”{ "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" ] }}Input schema
Section titled “Input schema”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": { "anyOf": [ { "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" }, { "type": "null" } ] }, "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" }, "translateToLanguages": { "items": { "enum": [ "english", "hungarian", "german", "french", "spanish", "italian" ], "type": "string" }, "type": "array" } }, "required": [ "organizationId" ], "type": "object"}Output schema
Section titled “Output schema”{ "$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"}