Skip to main content
Grant or update a user’s access to a secret path. Requires admin grant on the path.

Tool details

FieldValue
Nameset_upload_grant
GroupUploads

Playground

Input schema

Input schema
{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug"
    },
    "path": {
      "type": "string",
      "description": "Path prefix. Must be URL-encoded if it contains special characters or spaces."
    },
    "user_id": {
      "type": "string",
      "description": "User ID to grant access"
    },
    "permission": {
      "type": "string",
      "enum": [
        "read",
        "write",
        "admin"
      ],
      "description": "Permission level",
      "default": "read"
    }
  },
  "required": [
    "project_reference",
    "path",
    "user_id"
  ],
  "additionalProperties": false,
  "description": "Input schema for the set_upload_grant tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

Output schema
{
  "type": "object",
  "properties": {
    "user_id": {
      "type": "string",
      "description": "The user id associated with this tool result."
    },
    "permission": {
      "type": "string",
      "description": "The permission associated with this tool result."
    },
    "created_at": {
      "type": "string",
      "description": "Creation timestamp in ISO 8601 format."
    }
  },
  "required": [
    "user_id",
    "permission",
    "created_at"
  ],
  "additionalProperties": false,
  "description": "Structured result returned by the set_upload_grant tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}