--- updatedAt: 2026-04-20T20:26:21.000Z agentTools: projectIndex: https://docs.wistia.com/llms.txt --- # Show Folder Retrieves a single folder (previously called project). ## Requires api token with one of the following permissions ``` Read all folder and media data ``` Tokens with the "Act with a team member's permissions" permission (`all:delegate_to_contact_permissions` scope) can also be used. Requests made with such a token are authorized using the permissions of the contact assigned to the token. An [expiring access token](https://docs.wistia.com/reference/post_expiring-token) created with the `all:delegate_to_contact_permissions` scope and an authorization for this folder can also be used; any permission granted on a folder allows showing it. # OpenAPI definition ````json { "openapi": "3.1.1", "info": { "title": "Data API", "description": "Wistia Data API", "version": "2026.09.0" }, "servers": [ { "url": "https://api.wistia.com/modern" } ], "security": [ { "BearerAuth": [] } ], "tags": [ { "name": "Folders" } ], "paths": { "/folders/{id}": { "get": { "summary": "Show Folder", "x-speakeasy-group": "folders", "x-speakeasy-name-override": "get", "description": "Retrieves a single folder (previously called project).\n\n## Requires api token with one of the following permissions\n```\nRead all folder and media data\n```\n\nTokens with the \"Act with a team member's permissions\" permission\n(`all:delegate_to_contact_permissions` scope) can also be used. Requests\nmade with such a token are authorized using the permissions of the\ncontact assigned to the token.\n\nAn [expiring access token](https://docs.wistia.com/reference/post_expiring-token)\ncreated with the `all:delegate_to_contact_permissions` scope and an\nauthorization for this folder can also be used; any permission granted on a\nfolder allows showing it.\n", "parameters": [ { "name": "id", "in": "path", "description": "Folder Hashed ID", "required": true, "schema": { "description": "Hashed ID of the folder (e.g., \"4d23503f70\")", "type": "string" } }, { "name": "X-Wistia-API-Version", "in": "header", "required": true, "schema": { "type": "string", "default": "2026-09" } } ], "responses": { "200": { "description": "A single folder", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "description": "A folder (previously called a project) is a container in which to organize media into. It can be\nused to set permissions that apply to all the media in the folder as well as\norganizing media into subfolders (previously called media groups).\n", "properties": { "id": { "description": "A unique numeric identifier for the folder within the system.", "type": "integer", "examples": [ 22570 ] }, "name": { "description": "The folder’s display name.", "type": "string", "examples": [ "My Folder Title" ] }, "description": { "description": "The folder’s description.", "type": [ "string", "null" ], "examples": [ "About My Folder" ] }, "media_count": { "description": "The number of different medias that have been uploaded to the folder.", "type": "integer", "examples": [ 2 ] }, "medias": { "description": "A link to where you can fetch the medias for this folder.", "unevaluatedProperties": false, "type": "object", "properties": { "url": { "description": "A URL for fetching all child records of the parent record.", "type": "string" } } }, "created": { "description": "The date that the folder was originally created.", "type": "string", "format": "date-time", "examples": [ "2010-08-13T18:47:39+00:00" ] }, "updated": { "description": "The date that the folder was last updated.", "type": "string", "format": "date-time", "examples": [ "2010-08-19T21:47:00+00:00" ] }, "hashed_id": { "description": "A private hashed id, uniquely identifying the folder within the system.", "type": "string", "examples": [ "4d23503f70" ] }, "public": { "description": "A boolean indicating whether the folder is available for public (anonymous) viewing.", "type": "boolean", "examples": [ false ] }, "public_id": { "description": "If the folder is public, this field contains a string representing the ID used for referencing the folder in public URLs.", "type": [ "string", "null" ], "examples": [ "4bD" ] }, "anonymous_can_upload": { "type": "boolean", "examples": [ false ] }, "anonymous_can_download": { "type": "boolean", "examples": [ false ] }, "kind": { "description": "Indicates the folder's access scope, relative to the requesting user. One of:\n- `library`: a library the requester owns. Libraries can still be shared with specific contacts or contact groups; the only restriction is that they cannot be shared with the whole account.\n- `shared`: a folder the requester has access to via a Contact or ContactGroup sharing — this includes both shared folders and another contact's library that the requester has been granted access to.\n- `account`: a folder shared with the whole account (everyone in the company can see it).\n", "type": "string", "enum": [ "library", "shared", "account" ], "examples": [ "shared" ] }, "personal_library": { "description": "Whether this folder is someone's personal library (\"My Library\"). Unlike `kind`, this is a property of the folder itself and does not depend on who is requesting — it is `true` for a personal library even when that library has been shared with you (where `kind` would read `shared`). Use this, not `kind`, to tell whether a folder is a personal library.\n", "type": "boolean", "examples": [ false ] }, "cursor": { "description": "A cursor for stable pagination based on current `sort_by` order. You can pass this to `cursor[before]` or `cursor[after]` as a parameter to fetch the records before or after this record in the same sort order. This is only populated if records were fetched with `cursor[enabled]`, or `cursor[before]` or `cursor[after]`.", "type": [ "string", "null" ] } }, "required": [ "id", "name", "media_count", "created", "updated", "hashed_id", "public", "public_id", "kind", "personal_library", "medias" ] } } } }, "401": { "description": "Unauthorized, invalid or missing token", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "code": { "description": "A machine-readable identifier for the specific authorization failure.", "type": "string", "enum": [ "unauthorized_credentials", "account_inactive", "unauthorized_scope", "unauthorized_params" ] }, "error": { "type": "string", "examples": [ "Invalid credentials." ] } } } } } }, "404": { "description": "Resource not found", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "error": { "type": "string", "examples": [ "Folder with ID 'fakeid' not found." ] } } } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "unevaluatedProperties": false, "type": "object", "properties": { "error": { "type": "string", "examples": [ "Internal server error" ] } } } } } } }, "tags": [ "Folders" ], "x-readme": { "code-samples": [ { "name": "Typescript (SDK)", "language": "javascript", "code": "import { Wistia } from \"@wistia/wistia-api-client\";\n\nconst wistia = new Wistia({\n bearerAuth: process.env[\"WISTIA_BEARER_AUTH\"] ?? \"\",\n});\n\nasync function run() {\n const result = await wistia.folders.get({\n id: \"\",\n });\n\n console.log(result);\n}\n\nrun();" } ] } } } }, "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer" } } }, "x-readme": { "samples-languages": [ "javascript", "shell", "node", "python", "ruby" ] } } ````