---
canonical_url: "https://docs.composio.dev/toolkits/dribbble"
markdown_url: "https://docs.composio.dev/toolkits/dribbble.md"
product: "platform"
version: null
last_updated: null
---

# Dribbble

Dribbble is a design community and publishing platform for managing shots, projects, and attachments. Automated mutations must be specifically requested by the user.

- **Category:** images & design
- **Auth:** OAUTH2
- **Composio-managed OAuth available?** No
- **Tools:** 12
- **Triggers:** 0
- **Slug:** `DRIBBBLE`
- **Version:** 00000000_00

## Tools

### Create Project

**Slug:** `DRIBBBLE_CREATE_PROJECT`

Create a project for the connected Dribbble user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the new project. |
| `description` | string | No | Optional project description. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Shot

**Slug:** `DRIBBBLE_CREATE_SHOT`

Upload an image to create a public Dribbble shot asynchronously. The connected user must be a player or team and eligible to upload shots. Returns the shot location without polling or claiming processing is complete.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | Tags for the shot, with at most 12 entries. |
| `image` | object | Yes | GIF, JPG, or PNG image for the shot. It must be exactly 400x300 or 800x600 pixels and no larger than 8 MB. |
| `title` | string | Yes | Title for the new shot. |
| `team_id` | integer | No | Team ID to publish under. The connected user must belong to the team or authenticate as that team. |
| `description` | string | No | Optional description for the shot. |
| `low_profile` | boolean | No | Whether to publish the shot with reduced profile visibility. |
| `scheduled_for` | string | No | ISO 8601 publication time. Scheduling requires a Pro user, team, or team membership. |
| `rebound_source_id` | integer | No | ID of the source shot when this shot is a rebound. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Project

**Slug:** `DRIBBBLE_DELETE_PROJECT`

Permanently delete a project belonging to the connected Dribbble user. Returns deletion confirmation and the provider's project fields when supplied.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | integer | Yes | ID of the project to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Shot

**Slug:** `DRIBBBLE_DELETE_SHOT`

Permanently delete a shot owned by the connected Dribbble user. This action is irreversible and returns the deleted shot ID as confirmation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shot_id` | integer | Yes | ID of the owned shot to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Shot Attachment

**Slug:** `DRIBBBLE_DELETE_SHOT_ATTACHMENT`

Permanently delete an attachment from a shot owned by the connected Dribbble user. This action is irreversible and returns both IDs as confirmation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shot_id` | integer | Yes | ID of the shot containing the attachment. |
| `attachment_id` | integer | Yes | ID of the attachment to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current User

**Slug:** `DRIBBBLE_GET_CURRENT_USER`

Return the connected Dribbble user's profile, account capabilities, teams, and shot-upload eligibility.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `if_none_match` | string | No | Previously returned ETag. Dribbble returns 304 when the user is unchanged. |
| `if_modified_since` | string | No | Previously returned Last-Modified HTTP date. Dribbble returns 304 when the user has not changed since this time. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get My Shot

**Slug:** `DRIBBBLE_GET_MY_SHOT`

Return one shot owned by the connected user, including its media, tags, projects, and attachments. Choose HTML or plain-text description representation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shot_id` | integer | Yes | ID of the shot owned by the connected user to retrieve. |
| `description_media_type` | string ("application/vnd.dribbble.v2.html+json" | "application/vnd.dribbble.v2.text+json") | No | Shot-description representation. Use the html media type for description or the text media type for description_text. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List My Projects

**Slug:** `DRIBBBLE_LIST_MY_PROJECTS`

Return one page of projects belonging to the connected Dribbble user, with a safe cursor for the next page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `per_page` | integer | No | Maximum projects to return in this page (1-100). Dribbble may not honor the requested size on every collection. |
| `next_cursor` | string | No | Continuation cursor returned by a previous call. Omit it to fetch the first page, and pass it back unchanged to fetch the next page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List My Shots

**Slug:** `DRIBBBLE_LIST_MY_SHOTS`

Return one page of shots owned by the connected Dribbble user, with a safe cursor and selectable HTML or plain-text description representation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `per_page` | integer | No | Maximum shots to return in this page (1-100). Dribbble may not honor the requested size on every collection. |
| `next_cursor` | string | No | Continuation cursor returned by a previous call. Omit it to fetch the first page, and pass it back unchanged to fetch the next page. |
| `description_media_type` | string ("application/vnd.dribbble.v2.html+json" | "application/vnd.dribbble.v2.text+json") | No | Shot-description representation. Use the html media type for description or the text media type for description_text. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Project

**Slug:** `DRIBBBLE_UPDATE_PROJECT`

Update the name or description of a project belonging to the connected user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Replacement project name. Omit to preserve the current name. |
| `project_id` | integer | Yes | ID of the project to update. |
| `description` | string | No | Replacement project description. Omit to preserve the current description. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Shot

**Slug:** `DRIBBBLE_UPDATE_SHOT`

Update an owned Dribbble shot's metadata and choose the HTML or plain-text description representation returned in the response.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | Complete replacement list of up to 12 tags; [] clears all tags. |
| `title` | string | No | Replacement shot title. Omit to preserve the current title; null is not accepted. |
| `shot_id` | integer | Yes | ID of the owned shot to update. |
| `team_id` | integer | No | Team ID to associate; omit to preserve the current association. |
| `description` | string | No | Replacement shot description. Omit to preserve it; null is not accepted. |
| `low_profile` | boolean | No | Replacement visibility setting. Omit to preserve it; null is not accepted. |
| `remove_team` | boolean | No | Set true to remove the team association; cannot be combined with team_id. |
| `scheduled_for` | string | No | New ISO 8601 publication time. Requires Pro or team capability. |
| `description_media_type` | string ("application/vnd.dribbble.v2.html+json" | "application/vnd.dribbble.v2.text+json") | No | Response description representation. Use the html media type for description or the text media type for description_text. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upload Shot Attachment

**Slug:** `DRIBBBLE_UPLOAD_SHOT_ATTACHMENT`

Upload a file attachment to an owned Dribbble shot asynchronously. This requires a Pro user, team, or team membership. A successful response only confirms acceptance; retrieve the shot later to discover the attachment ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | Yes | Attachment file to upload, no larger than 10 MB. Uploading attachments requires a Pro user, team, or team membership. |
| `shot_id` | integer | Yes | ID of the owned shot that will receive the attachment. The connected user must be Pro, a team, or a team member. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |