Clip Projects

List user's clip projects

Info

Required scope: clips.read

Warning

This method requires authentication

Retrieve a paginated list of the user's clip projects.

curl -H "Authorization: Bearer [access token]" \
     https://api.restream.io/v2/user/clips/projects

Query Parameters:

Parameter	Type	Description
`limit`	number	Maximum number of projects to return (max `100`)
`cursor`	string	Cursor for pagination. Use `nextCursor` from the previous response
`sortBy`	string	Sort order for results: `CreatedAt` or `LastActivity` (default: `CreatedAt`)

All query parameters are optional.

Example request:

curl -H "Authorization: Bearer [access token]" \
     "https://api.restream.io/v2/user/clips/projects?limit=1&sortBy=LastActivity"

Response

Success

Error

{
  "projects": [
    {
      "projectId": "31a1e161-67aa-4a9e-a95b-3cb37ab6ea89",
      "sourceTypeName": "Event",
      "sourceIdentifier": "61c2559a-2acf-4420-ac01-78786d06da5c",
      "title": "My first live stream",
      "clipsCount": 3,
      "clipThumbnails": [
        "https://example.com/thumbnail1.jpg",
        "https://example.com/thumbnail2.jpg",
        "https://example.com/thumbnail3.jpg"
      ],
      "generatingClipsNow": false,
      "createdAt": "2026-01-28T15:50:30.420Z"
    }
  ],
  "pagination": {
    "nextCursor": "eyJzb3J0VmFsdWUi...",
    "hasMore": true
  }
}