Skip to main content
Set or update visibility on an upload folder path prefix. Creates the setting if it does not exist (upsert). Tiers: project (project members), public (anyone), private (granted users only).

​
Tool details

FieldValue
Nameset_upload_visibility
GroupUploads

​
Playground

​
Input schema

Input schema
{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug"
    },
    "path": {
      "type": "string",
      "description": "Path prefix (e.g., \"assets/\", \"public/\"). Must be URL-encoded if it contains special characters or spaces."
    },
    "visibility": {
      "type": "string",
      "enum": [
        "project",
        "public",
        "private"
      ],
      "description": "Visibility tier"
    }
  },
  "required": [
    "project_reference",
    "path",
    "visibility"
  ],
  "additionalProperties": false,
  "description": "Input schema for the set_upload_visibility tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

​
Output schema

Output schema
{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "The path associated with this tool result."
    },
    "visibility": {
      "type": "string",
      "description": "The visibility associated with this tool result."
    }
  },
  "required": [
    "path",
    "visibility"
  ],
  "additionalProperties": false,
  "description": "Structured result returned by the set_upload_visibility tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}