get https://api.shift.io/v4/core/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 MediaSilo, 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 MediaSilo, 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. |