{"__v":1,"_id":"54db7b9f1a14312100313997","category":{"__v":7,"_id":"54fdad6e660db63700c23b82","pages":["55fbef82af72eb0d0007df93","55fbf623e013770d008fcba8","5617bd3a26e3db230054fba4","5617c4a6f8c9632100ac74f5","561ed6fd0a04340d00d8a0b0","562156adf4e0352100cbf268","562a5c846049f20d0032520b"],"project":"54d0fd1d095c470d00d1646d","version":"54d0fd1e095c470d00d16470","sync":{"url":"","isSync":false},"reference":true,"createdAt":"2015-03-09T14:25:50.133Z","from_sync":false,"order":2,"slug":"api-reference","title":"API Reference"},"editedParams":true,"editedParams2":true,"project":"54d0fd1d095c470d00d1646d","user":"54db525474dfff3700f161e9","version":{"__v":20,"_id":"54d0fd1e095c470d00d16470","project":"54d0fd1d095c470d00d1646d","createdAt":"2015-02-03T16:53:50.090Z","releaseDate":"2015-02-03T16:53:50.090Z","categories":["54d0fd1e095c470d00d16471","54d8b5e68934140d00496544","54db6361c6a4d40d0034b8f7","54db638208ea010d00ab1fdd","54db639008ea010d00ab1fde","54db6547c6a4d40d0034b8fd","54db83482092743700ea6ee1","54db84afc6a4d40d0034b93c","54db8805c6a4d40d0034b93f","54db8de9c6a4d40d0034b961","54db931ac6a4d40d0034b96d","54e49219e4365521006fd9ee","54e74fcc652d7c1900cbe737","54e74ffd3c1e111700d05762","54e77e0a523b1b2f00e6f313","54e784affdabe62500fcddcf","54e784fa523b1b2f00e6f319","54e785de8ae8911900cd42c5","54fdad6e660db63700c23b82","54fdff31f7b1202100a25e06"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-02-11T15:56:15.867Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[{"name":"","code":"{\n  \"collection\": {\n    \"database_id\": \"my_database\",\n    \"description\": \"\",\n    \"origin\": \"\",\n    \"public\": false,\n    \"username\": \"YOUR_USERNAME\",\n    \"id\": \"COLLECTION_ID\",\n    \"collection_name\": \"my_collection\"\n  }\n}","language":"json","status":200}]},"auth":"required","params":[{"_id":"54db9c529f8ef11900f4df4a","ref":"","in":"path","required":true,"desc":"Name or id of the database.","default":"","type":"string","name":"database_id"},{"_id":"54db7b9f1a1431210031399b","ref":"","in":"body","required":true,"desc":"Name of collection.","default":"","type":"string","name":"collection_name"},{"_id":"54db7b9f1a1431210031399a","ref":"","in":"body","required":false,"desc":"Description of collection.","default":"","type":"string","name":"description"},{"_id":"54db7b9f1a14312100313999","ref":"","in":"body","required":false,"desc":"True if the collection is public, false otherwise.","default":"false","type":"boolean","name":"public"},{"_id":"54db7b9f1a14312100313998","ref":"","in":"body","required":false,"desc":"Public collection identifier of one existing shared collection. When this parameter is informed, this new collection will be linked to shared collection.","default":"","type":"string","name":"origin"}],"url":"/databases/:database_id/collections"},"isReference":true,"order":6,"body":"Creates a new collection in the authenticated user account. Returns a JSON object containing the new collection information.\n\n### Sample Request\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl --user <API-KEY>:\\\"\\\" -k -H \\\"Content-Type: application/json\\\" -XPOST \\\"https://api.gogeo.io/1.0/databases/my_database/collections\\\" -d '{\\n  \\\"collection_name\\\": \\\"my_collection\\\",\\n  \\\"description\\\": \\\"a new collection\\\"\\n}'\",\n      \"language\": \"curl\",\n      \"name\": null\n    }\n  ]\n}\n[/block]\n### Sample Response\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"collection\\\": {\\n    \\\"database_id\\\": \\\"my_database\\\",\\n    \\\"description\\\": \\\"\\\",\\n    \\\"origin\\\": \\\"\\\",\\n    \\\"public\\\": false,\\n    \\\"username\\\": \\\"YOUR_USERNAME\\\",\\n    \\\"id\\\": \\\"COLLECTION_ID\\\",\\n    \\\"collection_name\\\": \\\"my_collection\\\"\\n  }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n### Sample Request - Using a shared collection\n\nIn the example below, a collection called *new_collection* is created and connected to a shared collection with *COLLECTION_ID* using the *origin* parameter. You can edit the shared collections which you are the owner. To obtain the id from a shared collection you can use the [/collections/shared](doc:list-shared-collections) endpoint.\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"curl --user <API-KEY>:\\\"\\\" -k -H \\\"Content-Type: application/json\\\" -XPOST \\\"https://api.gogeo.io/1.0/databases/my_database/collections\\\" -d '{\\n  \\\"collection_name\\\": \\\"new_collection\\\",\\n  \\\"description\\\": \\\"imported from a shared collection\\\",\\n  \\\"origin\\\": \\\"COLLECTION_ID\\\"\\n}'\",\n      \"language\": \"curl\"\n    }\n  ]\n}\n[/block]\n### Sample Response\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"collection\\\": {\\n    \\\"database_id\\\": \\\"my_database\\\",\\n    \\\"description\\\": \\\"\\\",\\n    \\\"origin\\\": \\\"COLLECTION_ID\\\",\\n    \\\"public\\\": false,\\n    \\\"username\\\": \\\"YOUR_USERNAME\\\",\\n    \\\"id\\\": \\\"NEW_COLLECTION_ID\\\",\\n    \\\"collection_name\\\": \\\"new_collection\\\"\\n  }\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n[block:html]\n{\n  \"html\": \"<div class=\\\"panel panel-info teste\\\" >\\n  <div class=\\\"panel-body\\\">\\n    This endpoint requires an API key. See <a href=\\\"basic-auth\\\">Basic Authentication</a> for more information about the goGeo authentication system.\\n\\t\\t<br><br>\\n\\t  If you don't have an access key yet, <a href=\\\"https://console.gogeo.io/signup\\\">sign up</a> and grab yours!\\n  </div>\\n</div>\\n\"\n}\n[/block]\n---\n[block:html]\n{\n  \"html\": \"<div class='div-middle'> \\n  <a href='#'>\\n    Top page &spades; </div>\\n  </a>\\n</div>\\n\\n<div class='div-back'> \\n  <a href='/v1.0/docs/collections'>\\n    &laquo; Back \\n  </a>\\n</div>\\n\\n<div class='div-forward'> \\n  <a href='/v1.0/docs/list-all-collections'>\\n    Next &raquo; </div>\\n  </a>\\n</div>\\n\\n<style>\\n\\t.div-back {\\n  \\tpadding-left: 15px;\\n\\t\\tmargin-top: -20px;\\n  }\\n  \\n  .div-middle {\\n  \\ttext-align: center;\\n\\t\\tmargin-top: -15px;\\n  }\\n  \\n  .div-forward {\\n  \\tfloat: right;\\n    padding-right: 15px;\\n\\t\\tmargin-top: -20px;\\n  }\\n</style>\"\n}\n[/block]","excerpt":"Creates a new collection in the authenticated user account.","slug":"create-a-collection","type":"post","title":"Create a collection"}

postCreate a collection

Creates a new collection in the authenticated user account.

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Path Params

database_id:
required
string
Name or id of the database.

Body Params

collection_name:
required
string
Name of collection.
description:
string
Description of collection.
public:
booleanfalse
True if the collection is public, false otherwise.
origin:
string
Public collection identifier of one existing shared collection. When this parameter is informed, this new collection will be linked to shared collection.

Result Format


Documentation

Creates a new collection in the authenticated user account. Returns a JSON object containing the new collection information. ### Sample Request [block:code] { "codes": [ { "code": "curl --user <API-KEY>:\"\" -k -H \"Content-Type: application/json\" -XPOST \"https://api.gogeo.io/1.0/databases/my_database/collections\" -d '{\n \"collection_name\": \"my_collection\",\n \"description\": \"a new collection\"\n}'", "language": "curl", "name": null } ] } [/block] ### Sample Response [block:code] { "codes": [ { "code": "{\n \"collection\": {\n \"database_id\": \"my_database\",\n \"description\": \"\",\n \"origin\": \"\",\n \"public\": false,\n \"username\": \"YOUR_USERNAME\",\n \"id\": \"COLLECTION_ID\",\n \"collection_name\": \"my_collection\"\n }\n}", "language": "json" } ] } [/block] ### Sample Request - Using a shared collection In the example below, a collection called *new_collection* is created and connected to a shared collection with *COLLECTION_ID* using the *origin* parameter. You can edit the shared collections which you are the owner. To obtain the id from a shared collection you can use the [/collections/shared](doc:list-shared-collections) endpoint. [block:code] { "codes": [ { "code": "curl --user <API-KEY>:\"\" -k -H \"Content-Type: application/json\" -XPOST \"https://api.gogeo.io/1.0/databases/my_database/collections\" -d '{\n \"collection_name\": \"new_collection\",\n \"description\": \"imported from a shared collection\",\n \"origin\": \"COLLECTION_ID\"\n}'", "language": "curl" } ] } [/block] ### Sample Response [block:code] { "codes": [ { "code": "{\n \"collection\": {\n \"database_id\": \"my_database\",\n \"description\": \"\",\n \"origin\": \"COLLECTION_ID\",\n \"public\": false,\n \"username\": \"YOUR_USERNAME\",\n \"id\": \"NEW_COLLECTION_ID\",\n \"collection_name\": \"new_collection\"\n }\n}", "language": "json" } ] } [/block] [block:html] { "html": "<div class=\"panel panel-info teste\" >\n <div class=\"panel-body\">\n This endpoint requires an API key. See <a href=\"basic-auth\">Basic Authentication</a> for more information about the goGeo authentication system.\n\t\t<br><br>\n\t If you don't have an access key yet, <a href=\"https://console.gogeo.io/signup\">sign up</a> and grab yours!\n </div>\n</div>\n" } [/block] --- [block:html] { "html": "<div class='div-middle'> \n <a href='#'>\n Top page &spades; </div>\n </a>\n</div>\n\n<div class='div-back'> \n <a href='/v1.0/docs/collections'>\n &laquo; Back \n </a>\n</div>\n\n<div class='div-forward'> \n <a href='/v1.0/docs/list-all-collections'>\n Next &raquo; </div>\n </a>\n</div>\n\n<style>\n\t.div-back {\n \tpadding-left: 15px;\n\t\tmargin-top: -20px;\n }\n \n .div-middle {\n \ttext-align: center;\n\t\tmargin-top: -15px;\n }\n \n .div-forward {\n \tfloat: right;\n padding-right: 15px;\n\t\tmargin-top: -20px;\n }\n</style>" } [/block]

User Information

Try It Out

post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}