Restream icon

Restream

Access Restream Events, Recordings, and Clips using the Restream API

Actions9

Clip Project → Get Many

AI-generated

Summary

Retrieve many clip projects for the authenticated user with optional pagination, limiting, and sorting.

Inputs

  • returnAll — Whether to return all results or only up to a given limit. When true, pagination continues via cursor until hasMore is false.
  • limit — Maximum number of results to return. Only used when returnAll is false. Accepts 1–100, default 50.
  • sortBy — Sort criterion for returned projects. Options: CreatedAt (default), LastActivity.
  • requestOptions — Optional collection of request-level settings, including batching (size and interval) to throttle API calls.
  • allowUnauthorizedCerts — Accept response even if SSL certificate validation fails. Boolean, no data expression.
  • proxy — HTTP proxy URL (e.g. http://myproxy:3128). Include username:password@ for authenticated proxies.
  • timeout — Request timeout in milliseconds. Minimum 1, default 10000.

Output shape

The API response body is expected to contain a projects property, extracted via post-receive routing. The returned array length respects the limit parameter when returnAll is false; otherwise pagination continues while pagination.hasMore is true, using nextCursor for subsequent requests.

Generic node-level credentials (restreamOAuth2Api) and base URL (https://api.restream.io) apply. Proxy, SSL, and timeout settings affect the underlying HTTP request.

Examples

Example 1: Fetch up to 20 clip projects sorted by last activity.

returnAll: false, limit: 20, sortBy: LastActivity

Example 2: Fetch all clip projects with batched requests.

returnAll: true, requestOptions.batching.batchSize: 50, requestOptions.batching.batchInterval: 1000

Links

Discussion