GET /v1/folders
List folders with pagination and free-text search.
GET /v1/folders returns a paginated list of folders.
Authentication
Send an organization API key in x-api-key or
Authorization: Bearer <key>.
Query Parameters
| Name | Type | Default | Description |
|---|---|---|---|
page | integer | 1 | Page number to return. |
limit | integer | 20 | Number of results per page. Maximum: 100. |
q | string | "" | Free-text search term. |
Example
curl "https://api.blueputto.com/v1/folders?page=1&limit=20&q=archive" \
-H "x-api-key: YOUR_API_KEY"Success Response
200 OK
{
"data": [{}],
"meta": {
"page": 1,
"limit": 20,
"totalObjects": 1,
"totalPages": 1,
"hasNextPage": false,
"hasPrevPage": false
}
}Error Responses
400 Bad Request401 Unauthorized429 Too Many Requests