Create a collection.

17May2010

Create a new collection, with some metadata. The title and description must be set with an extra /collection/{coll_id} [POST] call.

Request URL

/collection/create [POST]

Request Authorization

This call needs EGA authentication.

Request Parameters

Parameter (Type)DescriptionRequiredDefault valueMax. length
user_id (ALPHA_NUM)The user ID, will become the owner of the collection.Required-
category (BOOL)Used to identify main category collections, use [GET] /collection?category=true to get these collections.Optionalfalse-
description (STRING)Description of the new collection.Optional-
group_id (ALPHA_NUM)The group ID, will be used for the group_id of the collection.Optional-
isprivate (BOOL)If isprivate = true, then the collction is not displayed in public lists, such as top 10, last uploaded, etc.Optionalfalse-
private (BOOL)Used to identify private collections, use [GET] /collection?private=true to get these collections.Optionalfalse-
public (BOOL)Used to identify public collections, use [GET] /collection?public=true to get these collections.Optionaltrue-
public_assign (BOOL)A 'true' value indicates that all users have access to the collection entitled to assets.Optionalfalse-
title (STRING)The title of the new collection.Optional-

Example Request

/collection/create [POST]

Example Response

<request_result>success</request_result>
<request_result_description></request_result_description>
<request_result_id>601</request_result_id>