Creating a Collection

  • Developer Preview
    Collections can be created by means of the REST API.


    Collections are created by means of the POST /pools/default/buckets/<bucket_name>/collections/<scope_name> HTTP method and URI.

    HTTP Method and URI

    POST /pools/default/buckets/<bucket_name>/collections/<scope_name>

    Requires the name parameter, whose value is the name of the collection to be created.


    Curl request syntax is as follows:

    curl -X POST -v -u [admin]:[password]
      -d name=<name-of-collection>


    Curl request example:

    curl -X POST -v -u Administrator:password \
    testBucket/collections/my_scope \
    -d name=my_collection_in_my_scope_1

    Raw HTTP request example:

    POST /pools/default/buckets/testBucket/collections/my_scope HTTP/1.1
    Host: localhost:8091
    Content-Type: application/json
    Authorization: Basic QWRtaW5pc3RyYXRvcjpwYXNzd29yZA==

    Response example:


    Response codes:

    HTTP/1.1 200 OK
    HTTP/1.1 401 Unauthorized
    HTTP/1.1 404 Object Not Found

    Possible errors:

    Requested resource not found.
    "name":"Length must be in range from 1 to 30"
    "name":"Can only contain characters A-Z, a-z, 0-9 and the following symbols _ - %"