Get a Project

GET /v1/projects/:id

Retrieve a single project folder by ID.

Example

curl https://api.vidocu.ai/v1/projects/0f7c1d8a-2c4b-4a9c-9f2a-1b8a3a5e0c11 \
  -H "Authorization: Bearer vdo_live_your_key_here"

Response 200 OK

{
  "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"
}

Required scope

OAuth tokens need the projects:read scope.

Errors

Status	Code	Cause
401	authentication_error	Invalid or missing API key
403	insufficient_scope	OAuth token missing projects:read
404	not_found	Project does not exist or belongs to a different workspace