Rename or change visibility
POST /v1/files/{id}FreeWrites
Renames a library file (write access) or sets its visibility (admin access on the file): org shares it with every member at their role, restricted keeps it to its creator, admins and explicit shares. Free.
MCP tool update_file · CLI geocode update-file · RPC POST /v1/ops/update_file
Input
| Field | Type | Description |
|---|---|---|
idpath, required | string | The file's id from list_files or save_file. |
namebody | string | |
visibilitybody | "org" | "restricted" |
Example request
curl -X POST "https://geocodeai.dev/v1/files/00000000-0000-4000-8000-000000000000" \ -H "Authorization: Bearer $GEOCODE_API_KEY" \ -H "Content-Type: application/json" \ -d '{"visibility":"restricted"}'Example response
See the description above for what this returns.
Errors
Failures are RFC 9457 problems. Common ones here: 400 invalid_input, 401 unauthorized, 429 rate_limited.