Import sheet
import_sheet
Section titled “import_sheet”Use this to import one or more exercise sheet 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": { "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" }, "sheetImportPlan": { "additionalProperties": false, "properties": { "sheets": { "items": { "additionalProperties": false, "properties": { "components": { "items": { "additionalProperties": false, "properties": { "componentId": { "pattern": "^[a-zA-Z0-9_-]{1,80}$", "type": "string" }, "description": { "minLength": 1, "type": "string" }, "targetFolderPath": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ] }, "titleOverride": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ] }, "translateToLanguages": { "items": { "enum": [ "english", "hungarian", "german", "french", "spanish", "italian" ], "type": "string" }, "type": "array" } }, "required": [ "componentId", "description" ], "type": "object" }, "minItems": 1, "type": "array" }, "sourceIndexes": { "items": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "minItems": 1, "type": "array" }, "targetFolderPath": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ] }, "titleOverride": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ] }, "translateToLanguages": { "items": { "enum": [ "english", "hungarian", "german", "french", "spanish", "italian" ], "type": "string" }, "type": "array" } }, "required": [ "sourceIndexes" ], "type": "object" }, "minItems": 1, "type": "array" } }, "required": [ "sheets" ], "type": "object" }, "singleSheet": { "default": false, "type": "boolean" }, "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" }, "targetFolderPath": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ] }, "titleOverride": { "minLength": 1, "type": "string" }, "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": { "jobs": { "items": { "additionalProperties": false, "properties": { "componentIds": { "items": { "type": "string" }, "type": "array" }, "fileName": { "type": "string" }, "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" }, "relativePath": { "type": "string" }, "sourceIndexes": { "items": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "type": "array" } }, "required": [ "jobId", "relativePath", "fileName" ], "type": "object" }, "type": "array" } }, "required": [ "jobs" ], "type": "object"}