{"_id":"54ac0037de18cc1400226dc7","project":"54343170fa5527080064f449","user":"54343147fa5527080064f43f","category":{"_id":"543435bfedce040800409244","__v":13,"pages":["543493365b10711400c6c48e","54349a445b10711400c6c515","5434a0fe0ef9c008001652ed","54aafac199f6581600167c9a","54ab036defb39016009e4d85","54ab09c699f6581600167cc4","54ab6a8499f6581600167d42","54abf047ec3be11400c8af25","54abfcf2de18cc1400226dbc","54abfe45ec3be11400c8af64","54ac0037de18cc1400226dc7","54c6a0d5f2ab9319008e81aa","54d52803ba860f0d003de534"],"project":"54343170fa5527080064f449","version":"54343531bfaa3d0800c4d4af","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2014-10-07T18:49:35.512Z","from_sync":false,"order":3,"slug":"projects","title":"Projects"},"version":{"_id":"54343531bfaa3d0800c4d4af","project":"54343170fa5527080064f449","__v":28,"forked_from":"54343170fa5527080064f44c","createdAt":"2014-10-07T18:47:13.086Z","releaseDate":"2014-10-07T18:47:13.086Z","categories":["54343531bfaa3d0800c4d4b0","543435b1edce040800409240","543435b9edce040800409241","543435bcedce040800409243","543435bfedce040800409244","543435c2edce040800409245","54370cc426469424002a6dfa","54370cf026469424002a6dfd","5437129d26469424002a6e2f","543712d226469424002a6e30","5480c8fd74904f1a00053c86","54aafc6eefb39016009e4d71","54ac1d36de18cc1400226e01","54ad59369219922100751732","54b41bcf4f25cb1600518d2c","54b533a3a806f40c0050d53c","54b54bbf96fe3c0b00d38d2a","54b688a27379a90c00f53a8a","54b699efbc1a46160005edfa","54b8191691011f0b00068804","54bfb002d03bfc0d0000e814","54bfb33ed03bfc0d0000e816","55a3e94e912a6e2300882cdb","55a56c370f354f0d00fd02a8","55e85ad034516037002e9325","5638ecb62fc5520d001a4cf9","572cba2fc310640e008f63d5","596e6e42c5b53b00509791b1"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"3.0.0","version":"3.0"},"__v":7,"parentDoc":null,"updates":["54c2cf22c2481c0d00b2f941"],"next":{"pages":[],"description":""},"createdAt":"2015-01-06T15:33:11.903Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Projects are a core building block of MediaSilo. All media must be associated with a project or a sub-folder within a project. Users gain access to media by being added to projects with a specific set of permissions (role templates).\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Delegation\"\n}\n[/block]\nMediaSilo uses **Project Managers** and **Project Owners** to delegate access to media. **Project Managers** and **Project Owners** can add and invite users to a project without the need of a \"central\" administrator to create user accounts. This approach makes it easy to deploy MediaSilo is organizations where centralized control is difficult or costly.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Scoping - What users see\"\n}\n[/block]\nUsers MediaSilo only see media contained in projects they have access to. This means Project A can be shared with Client A, and it will never be visible by Client B who only has access to Project B. Just as media is restricted this way, so are other endpoints such as Users and Contacts. \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Permissions\"\n}\n[/block]\nMediaSilo's **Administration** or **Project Owner** role is required for a user to edit or delete a project. It is possible to assign multiple project owners, which ensures that projects do not get accidentally abandoned once a user is disabled. \n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Project Limits\"\n}\n[/block]\nWhile most account levels in MediaSilo are unlimited, refer to your specific subscription to find out if there are any limits on the number of projects that can be created.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Data\"\n}\n[/block]\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"[ \\n  {\\n    \\\"dateCreated\\\": 1381431962000,\\n    \\\"description\\\": \\\"\\\",\\n    \\\"favorite\\\": false,\\n    \\\"folderCount\\\": 0,\\n    \\\"id\\\": \\\"A3C2EB00-9D98-0ACC-76BE2E681098809D\\\",\\n    \\\"name\\\": \\\"Space\\\",\\n    \\\"numericId\\\": 38202,\\n    \\\"ownerId\\\": \\\"A3BF60DD-E6ED-936E-D099E5C13A5A907E\\\"\\n    \\\"quicksite\\\": false\\n  }\\n]\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"**dateCreated**\",\n    \"1-0\": \"**id**\",\n    \"2-0\": \"**numericId**\",\n    \"3-0\": \"**name**\",\n    \"4-0\": \"**description**\",\n    \"5-0\": \"**ownerId**\",\n    \"6-0\": \"**folderCount**\",\n    \"7-0\": \"**favorite**\",\n    \"0-1\": \"Number\",\n    \"1-1\": \"String\",\n    \"2-1\": \"Number\",\n    \"3-1\": \"String\",\n    \"4-1\": \"String\",\n    \"6-1\": \"String\",\n    \"5-1\": \"String\",\n    \"7-1\": \"Boolean\",\n    \"0-2\": \"Eastern time\",\n    \"1-2\": \"Unique asset identifier\",\n    \"2-2\": \"Legacy id for project\",\n    \"3-2\": \"Project name\",\n    \"4-2\": \"Project description\",\n    \"5-2\": \"User ID of the project owner. By default, the user who creates the project is the first project owner.\",\n    \"6-2\": \"Number of folders in project\",\n    \"7-2\": \"Is marked as a favorite by the current user\",\n    \"h-0\": \"Name\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Description\",\n    \"8-0\": \"**quicksite**\",\n    \"9-0\": \"\",\n    \"8-1\": \"Boolean\",\n    \"8-2\": \"Whether this project is used by a QuickSite\"\n  },\n  \"cols\": 3,\n  \"rows\": 10\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Project Aggregates\"\n}\n[/block]\nBy passing _includeAggregates=1, the API will return additional information about each project.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"[\\n  {\\n    \\\"id\\\": \\\"B376864C-B3DC-EA40-33E34198928B79E4\\\",\\n    \\\"numericId\\\": 441,\\n    \\\"name\\\": \\\"Play\\\",\\n    \\\"description\\\": \\\"Test\\\",\\n    \\\"dateCreated\\\": 1192716830000,\\n    \\\"ownerId\\\": \\\"54950683-D322-4FDF-148117027CA45E58\\\",\\n    \\\"folderCount\\\": 0,\\n    \\\"aggregates\\\": {\\n      \\\"averageFileSize\\\": 23068.971962616823,\\n      \\\"totalDuration\\\": 4547577,\\n      \\\"totalFolders\\\": 0,\\n      \\\"totalAssets\\\": 107,\\n      \\\"totalFileSize\\\": 2468380,\\n      \\\"totalUsers\\\": 6,\\n      \\\"averageDuration\\\": 78406.5\\n    },\\n    \\\"favorite\\\": true,\\n    \\\"quickSite\\\": false\\n  }\\n]\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"overview-1","type":"basic","title":"Overview"}
Projects are a core building block of MediaSilo. All media must be associated with a project or a sub-folder within a project. Users gain access to media by being added to projects with a specific set of permissions (role templates). [block:api-header] { "type": "basic", "title": "Delegation" } [/block] MediaSilo uses **Project Managers** and **Project Owners** to delegate access to media. **Project Managers** and **Project Owners** can add and invite users to a project without the need of a "central" administrator to create user accounts. This approach makes it easy to deploy MediaSilo is organizations where centralized control is difficult or costly. [block:api-header] { "type": "basic", "title": "Scoping - What users see" } [/block] Users MediaSilo only see media contained in projects they have access to. This means Project A can be shared with Client A, and it will never be visible by Client B who only has access to Project B. Just as media is restricted this way, so are other endpoints such as Users and Contacts. [block:api-header] { "type": "basic", "title": "Permissions" } [/block] MediaSilo's **Administration** or **Project Owner** role is required for a user to edit or delete a project. It is possible to assign multiple project owners, which ensures that projects do not get accidentally abandoned once a user is disabled. [block:api-header] { "type": "basic", "title": "Project Limits" } [/block] While most account levels in MediaSilo are unlimited, refer to your specific subscription to find out if there are any limits on the number of projects that can be created. [block:api-header] { "type": "basic", "title": "Data" } [/block] [block:code] { "codes": [ { "code": "[ \n {\n \"dateCreated\": 1381431962000,\n \"description\": \"\",\n \"favorite\": false,\n \"folderCount\": 0,\n \"id\": \"A3C2EB00-9D98-0ACC-76BE2E681098809D\",\n \"name\": \"Space\",\n \"numericId\": 38202,\n \"ownerId\": \"A3BF60DD-E6ED-936E-D099E5C13A5A907E\"\n \"quicksite\": false\n }\n]", "language": "json" } ] } [/block] [block:parameters] { "data": { "0-0": "**dateCreated**", "1-0": "**id**", "2-0": "**numericId**", "3-0": "**name**", "4-0": "**description**", "5-0": "**ownerId**", "6-0": "**folderCount**", "7-0": "**favorite**", "0-1": "Number", "1-1": "String", "2-1": "Number", "3-1": "String", "4-1": "String", "6-1": "String", "5-1": "String", "7-1": "Boolean", "0-2": "Eastern time", "1-2": "Unique asset identifier", "2-2": "Legacy id for project", "3-2": "Project name", "4-2": "Project description", "5-2": "User ID of the project owner. By default, the user who creates the project is the first project owner.", "6-2": "Number of folders in project", "7-2": "Is marked as a favorite by the current user", "h-0": "Name", "h-1": "Type", "h-2": "Description", "8-0": "**quicksite**", "9-0": "", "8-1": "Boolean", "8-2": "Whether this project is used by a QuickSite" }, "cols": 3, "rows": 10 } [/block] [block:api-header] { "type": "basic", "title": "Project Aggregates" } [/block] By passing _includeAggregates=1, the API will return additional information about each project. [block:code] { "codes": [ { "code": "[\n {\n \"id\": \"B376864C-B3DC-EA40-33E34198928B79E4\",\n \"numericId\": 441,\n \"name\": \"Play\",\n \"description\": \"Test\",\n \"dateCreated\": 1192716830000,\n \"ownerId\": \"54950683-D322-4FDF-148117027CA45E58\",\n \"folderCount\": 0,\n \"aggregates\": {\n \"averageFileSize\": 23068.971962616823,\n \"totalDuration\": 4547577,\n \"totalFolders\": 0,\n \"totalAssets\": 107,\n \"totalFileSize\": 2468380,\n \"totalUsers\": 6,\n \"averageDuration\": 78406.5\n },\n \"favorite\": true,\n \"quickSite\": false\n }\n]", "language": "json" } ] } [/block]