List Projects

GET /v1/projects

List all project folders in your workspace with pagination, search, and sort.

Query parameters

Parameter	Type	Required	Default	Description
page	integer	No	1	Page number (minimum 1)
limit	integer	No	50	Results per page (1–100)
search	string	No	—	Case-insensitive name match
sortBy	string	No	updatedAt	One of updatedAt, createdAt, name
sortOrder	string	No	desc	asc or desc

Example

curl "https://api.vidocu.ai/v1/projects?limit=20&sortBy=name&sortOrder=asc" \
  -H "Authorization: Bearer vdo_live_your_key_here"

Response 200 OK

{
  "projects": [
    {
      "id": "0f7c1d8a-2c4b-4a9c-9f2a-1b8a3a5e0c11",
      "name": "Q1 Product Launch",
      "description": "All onboarding and demo videos for the Q1 launch",
      "thumbnailUrl": null,
      "createdAt": "2026-04-27T10:00:00.000Z",
      "updatedAt": "2026-04-27T10:00:00.000Z"
    }
  ],
  "pagination": {
    "total": 3,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  }
}

To list videos inside a project, use GET /v1/videos?projectId={id}. To list uncategorized videos, use GET /v1/videos?uncategorized=true.

Required scope

OAuth tokens need the projects:read scope.

Errors

Status	Code	Cause
400	validation_error	Invalid query parameter values
401	authentication_error	Invalid or missing API key
403	insufficient_scope	OAuth token missing projects:read