# The file object Files and folders form the workspace's shared file library. ## Attributes - `id` (integer) — Identifier assigned by the API. - `sport_id` (integer or null) — Sport context recorded for the file, when available. - `parent_id` (integer or null) — Parent folder ID, or null for the root. - `is_folder` (boolean) — Whether this record represents a folder. - `name` (string) — Original filename or folder name, up to 160 characters. - `friendly_name` (string or null) — Optional display name, up to 160 characters. Use null to clear it. - `description` (string or null) — Description, up to 160 characters. - `url` (string or null) — URL of an already-uploaded file. - `mime_type` (string or null) — Media type of the file. - `size` (integer or null) — File size in bytes. - `views` (integer) — Number of views recorded for the file. - `tsc` (integer or null) — Creation time as Unix seconds. - `tsu` (integer or null) — Last update time as Unix seconds. ## Example Example with fictional data and selected fields. ```json { "id": 16, "sport_id": 3, "parent_id": null, "is_folder": false, "name": "welcome.pdf", "friendly_name": "Welcome guide", "description": "Club information", "mime_type": "application/pdf", "size": 12345, "url": "https://files.example.com/welcome.pdf" } ```