Skip to main content

Authentication

This endpoint requires authentication using a Bearer token.
curl -X GET "https://api.dub.co/folders?page=1&pageSize=50" \
  -H "Authorization: Bearer <token>"

Query Parameters

The search term to filter the folders by.
page
number
default:"1"
The page number for pagination.
pageSize
number
default:"50"
The number of items per page. Maximum: 50

Response

Returns an array of folder objects.
id
string
The unique ID of the folder.
name
string
The name of the folder.
description
string | null
The description of the folder.
type
string
The type of the folder.
accessLevel
string | null
The access level of the folder within the workspace.
createdAt
date
The date the folder was created.
updatedAt
date
The date the folder was updated.
[
  {
    "id": "fold_abc123",
    "name": "Marketing Campaigns",
    "description": "Links for marketing campaigns",
    "type": "folder",
    "accessLevel": "write",
    "createdAt": "2024-01-01T00:00:00.000Z",
    "updatedAt": "2024-01-01T00:00:00.000Z"
  },
  {
    "id": "fold_xyz789",
    "name": "Product Launch",
    "description": "Product launch related links",
    "type": "folder",
    "accessLevel": "read",
    "createdAt": "2024-01-15T00:00:00.000Z",
    "updatedAt": "2024-01-15T00:00:00.000Z"
  }
]

Build docs developers (and LLMs) love