Get Item

Get a specific file or folder by ID. Use special IDs like "home", "favorites", "allshared", or "connectors" for system folders.

Parameters

Parameter	Type	Required	Description
`item_id`	`string`	Required	Item ID (stream ID) or alias: "home" (root folder), "favorites", "allshared", "connectors", "box", "top"
`include_deleted`	`boolean`	Optional	Include deleted items (default false)

Optional Flags

Parameter	Type	Required	Description
`include_children`	`boolean`	Optional	Include child items in response (default false)
`summary_only`	`boolean`	Optional	Return essential fields only (Id, Name, type, size, dates)

Examples

MCP Tool Call

{
  "name": "sharefile_getItem",
  "arguments": {
    "item_id": "example",
    "include_children": true,
    "include_deleted": true,
    "summary_only": true
  }
}

REST API

curl -X POST https://api.syncello.io/v1/tools/sharefile/getItem \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "item_id": "example",
  "include_children": true,
  "include_deleted": true,
  "summary_only": true
}'