List folders

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.storydoc.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Storydoc API MCP server": {
    "url": "https://docs.storydoc.com/mcp"
  }
}

GET /v2/folders

Bearer auth

The story folders the API key's creator can open - the folder tree they see in the dashboard (an administrator's key sees every folder) - with each folder's path and who can open it, in the same shape as a version's folder. A parent they cannot open is left out of path, and the folder's parentId is then null. Use it to pick a folderId for GET /v2/versions. A key scoped to one story lists only the folder that story is in (none if it sits at the root).

Responses

200 application/json

The folders
Hide response attribute Show response attribute object
- data array[object]
  
  Hide data attributes Show data attributes object
  
  id string
  
  name string
  
  path array[string]
  
  Folder names from the root down
  
  parentId string | null
  
  The parent folder's id; null at the top level
  
  sharedWithEveryone boolean
  
  True when everyone in your organization can open the folder (the app's "Share with everyone in your organization"). This is about your team, not the public.
  
  members array[object]
  
  Who can open the folder when it is not shared with everyone; empty when it is. Access is set per folder (a parent's members do not carry over), and organization administrators can open every folder without being listed.
  
  Hide members attributes Show members attributes object
  
  name string | null
  
  email string | null
  
  role string | null
  
  Values are Owner or Editor.
403 application/json

Authentication failed, the member who created the key has left the organization, or a legacy org token has been replaced by a newer one
Hide response attributes Show response attributes object
- error string
- code string
  
  VARIABLES_PLAN_REQUIRED when the story uses variables above the account's plan; absent for authentication failures.
- requiredPlan string
  
  With VARIABLES_PLAN_REQUIRED: the lowest plan that covers every blocked variable.
  
  Values are pro or team.
- variables array[object]
  
  With VARIABLES_PLAN_REQUIRED: the blocked variables and the plan each needs.
  
  Hide variables attributes Show variables attributes object
  
  name string
  
  requiredPlan string
429 application/json

Too many requests
Hide response attribute Show response attribute object
- error string
500 application/json

Internal server error
Hide response attributes Show response attributes object
- error string
- errorId string

GET /v2/folders

curl \
 --request GET 'https://api.storydoc.com/v2/folders' \
 --header "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": [
    {
      "id": "64f1c2a9e1b2c3d4e5f60718",
      "name": "Enterprise",
      "path": [
        "Sales",
        "Enterprise"
      ],
      "parentId": "string",
      "sharedWithEveryone": true,
      "members": [
        {
          "name": "Dana Lee",
          "email": "dana@company.com",
          "role": "Owner"
        }
      ]
    }
  ]
}

Response examples (403)

{
  "error": "Access denied"
}

Response examples (429)

{
  "error": "Too many requests"
}

Response examples (500)

{
  "error": "Error occured",
  "errorId": "550e8400-e29b-41d4-a716-446655440000"
}