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.