POST
https://api.discovertext.com/api/v1/projects/{project_id}/buckets
Input: a JSON object of the bucket to be created and the {id} of the project to create the bucket in.
{ name: "{name_of_new_bucket}", // string, required, up to 120 characters description: "{bucket_description}" // string, optional up to 256 characters }
Return Value: A bucket item
{ "id": {bucket id}, "name": "{bucket name}", "description": "{bucket description}", "timestamp": "{iso timestamp when created}", "href": "{link to this item}", "links": [ { "name": "units", "href": "{link to bucket units}" } ] }
Note: you must have permissions to create buckets in the specified project id. If you do not, you will receive a 403 - Forbidden error.