projects

List Projects

List the workspace's projects, newest first. The implicit Default project is not a row and is never listed; resources with no project_id live in it. Archived projects are hidden unless include_archived=true, and purged ones unless include_purged=true. Cursor-paginated: omit cursor for the first page; walk pages while has_more is true (default page size 50, max 200).

get/v1/projects

Request

  • Base URL: https://api.speechify.ai
  • URL: https://api.speechify.ai/v1/projects
  • Auth: HTTP bearer

Query parameters

cursorstring

Opaque pagination cursor from a previous response.

limitinteger

Max items per page (default 50, max 200).

include_archivedboolean

Include archived projects. Defaults to false, so the list shows only live projects; archived ones stay readable by id.

include_purgedboolean

Include purged projects that are still inside their 30-day restore window, each carrying the purged_at stamp its deadline is measured from. Defaults to false, so the list shows only projects that still exist. This is the only read that returns a purged project: the by-id read answers 404 for one, and a project past its window is never listed, because it is awaiting permanent deletion and a restore would refuse it. Independent of include_archived: a purge runs only from the archived state, so asking for purged projects never means asking for every archived one as well.

Headers

Speechify-Versionstring

Response

The workspace's projects.

next_cursorstring nullable required

Opaque keyset cursor for the next page. Pass back as the cursor request parameter. null when the caller has reached the end of the list (has_more is also false in that case).

has_moreboolean required

True when more rows exist beyond this page.

Changes

No recorded changes to this operation across all 1 revision of this API.