Get all projects

Returns a list of the projects in your workspace and their properties

The projects call provides details about your project, including aggregates like total size and number of users. You can also use this call to obtain a project id for use in other calls. The following table defines the properties that are returned for each project.

id Each project has its own id. The project id is a required parameter whenever you make calls related to a specific project, such as creating a new asset inside a project, adding users to a project, and getting a list of all the assets in a project.
name Every project has a name.
description A project description is optional; this value is “null” if no description was entered.
dateCreated This is the Unix timestamp of the date and time the project was created.
lastActivity This is the Unix timestamp of the last activity in the project. “Activity” can include uploading or deleting an asset. Viewing assets is not counted as activity.
folderCount This is the total number of folders in the project, including subfolders and any empty folders.
favorite If “true,” the project has been favorited by the user whose API credentials are in use.
isWatermarked If “true,” SafeStream watermarking is enabled on the project.
poster This is the CloudFront URL of the image used as the project thumbnail on the Projects page in grid view. You can navigate to this URL to download the image. If the value is “null,” no thumbnail is currently uploaded.
banner This is the CloudFront URL of the image used as the project banner. When you open a project in Shift, the banner is the image you see at the top of the page. You can navigate to this URL to download the image. If the value is “null,” no banner is currently uploaded.
owner The properties in this object provide the id, name, and email of the user who created the project.
totalDuration This is the combined duration (in milliseconds) of all videos in the project.
totalUsers This is the number of users on the project.
totalFileSize This is the combined file size (in KBs) of all assets in the project.
retentionPolicy The properties in this object indicate the number of days after which files are automatically deleted. In Shift, a project’s retention (or “lifecycle”) policy is defined in the Policies tab in the Settings section. If “null,” no retention policy is set, and files are not deleted automatically.
Language
Authentication
Click Try It! to start a request and see the response here!