ic_files_put
ActiveTool of Immersive Commons
declared in 1.31.0
Upload a file (base64) into the IC secure vault and set who can see it. visibility: 'ic-members' (any IC member, default), 'grantees' (only the Clerk user ids you list, plus you + operators), or 'private' (only you + operators). Non-members get access via ic_files_grant (a signed link). Max 25MB per file, 500 files per member. Args: { filename, content_base64, content_type?, visibility?, grantees?: string[], label?, description?, tags?: string[] }. Returns: { ok, id, filename, size, visibility }. Required scope: files:write (ic-member+).
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"filename",
"content_base64"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 12,
"description": "Free-text tags, e.g. ['hackathon']."
},
"label": {
"type": "string",
"maxLength": 200,
"description": "Human title (defaults to filename)."
},
"filename": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Display filename (basename; sanitized)."
},
"grantees": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 100,
"description": "Clerk user ids allowed when visibility='grantees'."
},
"folder_id": {
"type": "string",
"maxLength": 64,
"description": "Put the file in this folder (d_...) instead of the vault root. You must own the folder (or be operator). Discover/create folders with ic_folders_list / ic_folder_create."
},
"visibility": {
"enum": [
"ic-members",
"grantees",
"private"
],
"type": "string",
"description": "Who can download. Default 'ic-members'."
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "What the file is."
},
"content_type": {
"type": "string",
"maxLength": 200,
"description": "MIME type, e.g. application/pdf."
},
"content_base64": {
"type": "string",
"minLength": 1,
"description": "File bytes, base64-encoded. Max 25MB decoded."
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Immersive Commons
https://github.com/immersive-commons/ic-skills
1/7 registries