Developer

Buckets

Get a bucket

GET /buckets/:id

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 2754,
  "name" : "Great Marks",
  "description" : "Collecting superb brand marks from the <a href=\"https://dribbble.com\">Dribbbleverse</a>.",
  "shots_count" : 251,
  "created_at" : "2011-05-20T21:05:55Z",
  "updated_at" : "2014-02-21T16:37:12Z",
  "user" : {
    "id" : 1,
    "name" : "Dan Cederholm",
    "username" : "simplebits",
    "html_url" : "https://dribbble.com/simplebits",
    "avatar_url" : "https://d13yacurqjgara.cloudfront.net/users/1/avatars/normal/dc.jpg?1371679243",
    "bio" : "Co-founder &amp; designer of <a href=\"https://dribbble.com/dribbble\">@Dribbble</a>. Principal of SimpleBits. Aspiring clawhammer banjoist.",
    "location" : "Salem, MA",
    "links" : {
      "web" : "http://simplebits.com",
      "twitter" : "https://twitter.com/simplebits"
    },
    "buckets_count" : 10,
    "comments_received_count" : 3395,
    "followers_count" : 29262,
    "followings_count" : 1728,
    "likes_count" : 34954,
    "likes_received_count" : 27568,
    "projects_count" : 8,
    "rebounds_received_count" : 504,
    "shots_count" : 214,
    "teams_count" : 1,
    "can_upload_shot" : true,
    "type" : "Player",
    "pro" : true,
    "buckets_url" : "https://dribbble.com/v1/users/1/buckets",
    "followers_url" : "https://dribbble.com/v1/users/1/followers",
    "following_url" : "https://dribbble.com/v1/users/1/following",
    "likes_url" : "https://dribbble.com/v1/users/1/likes",
    "shots_url" : "https://dribbble.com/v1/users/1/shots",
    "teams_url" : "https://dribbble.com/v1/users/1/teams",
    "created_at" : "2009-07-08T02:51:22Z",
    "updated_at" : "2014-02-22T17:10:33Z"
  }
}

Create a bucket

POST /buckets

Creating a bucket requires the user to be authenticated with the write scope.

Parameters

Name Type Description
name string Required. The name of the bucket.
description string A description of the bucket.

Example

{
  "name" : "Great Marks",
  "description" : "Collecting superb brand marks from the <a href=\"https://dribbble.com\">Dribbbleverse</a>."
}

Response

Status: 201 Created
Location: https://api.dribbble.com/v1/buckets/2754
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 2754,
  "name" : "Great Marks",
  "description" : "Collecting superb brand marks from the <a href=\"https://dribbble.com\">Dribbbleverse</a>.",
  "shots_count" : 251,
  "created_at" : "2011-05-20T21:05:55Z",
  "updated_at" : "2014-02-21T16:37:12Z"
}

Update a bucket

PUT /buckets/:id

Updating a bucket requires the user to be authenticated with the write scope. The authenticated user must also own the bucket.

Response

Status: 200 OK
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{
  "id" : 2754,
  "name" : "Great Marks",
  "description" : "Collecting superb brand marks from the <a href=\"https://dribbble.com\">Dribbbleverse</a>.",
  "shots_count" : 251,
  "created_at" : "2011-05-20T21:05:55Z",
  "updated_at" : "2014-02-21T16:37:12Z"
}

Delete a bucket

DELETE /buckets/:id

Deleting a bucket requires the user to be authenticated with the write scope. The authenticated user must also own the bucket.

Response

Status: 204 No Content
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59