# Zeplin

Zeplin is a design delivery platform that connects designers and developers, enabling access to design resources like projects, screens, components, and assets.

- **Category:** images & design
- **Auth:** OAUTH2, API_KEY
- **Tools:** 24
- **Triggers:** 0
- **Slug:** `ZEPLIN`
- **Version:** 20260211_00

## Tools

### Start OAuth authorization (PKCE)

**Slug:** `ZEPLIN_AUTH_O_AUTH_AUTHORIZE`

Tool to start OAuth 2.0 authorization code flow for Zeplin apps. Use when initiating user authorization; call before exchanging the code.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `state` | string | No | Random string for CSRF protection; echoed back in the callback. |
| `client_id` | string | Yes | Identifier of your Zeplin app (provided by Zeplin). |
| `redirect_uri` | string | Yes | Whitelisted redirect URI registered in Zeplin. Must be a valid URI. |
| `response_type` | string | No | Must be 'code' to initiate authorization code flow. |
| `code_challenge` | string | No | PKCE code challenge derived from code_verifier. |
| `code_challenge_method` | string ("plain" | "S256") | No | Transformation method used to generate the code_challenge. |

#### 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 Project Connected Components

**Slug:** `ZEPLIN_CONNECTED_COMPONENTS_PROJECT_LIST`

Tool to list connected components in a Zeplin project. Use when you have the project_id and need to retrieve connected components in a specific project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of connected components to return per page (1-100) |
| `offset` | integer | No | Zero-based offset for pagination |
| `project_id` | string | Yes | Unique ID of the Zeplin project to list connected components for |

#### 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 Project Colors

**Slug:** `ZEPLIN_PROJECT_COLORS_LIST`

Tool to list colors in a Zeplin project. Use when you need to fetch defined color tokens at the project level after obtaining the project ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | ID of the target project |
| `token_type` | string | No | Token type for Authorization header, typically 'Bearer' |
| `access_token` | string | No | Access token value to include in Authorization header |
| `authorization` | string | No | Full Authorization header value. If provided, overrides token_type/access_token |

#### 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 Color

**Slug:** `ZEPLIN_PROJECT_COLOR_UPDATE`

Tool to update a color in a Zeplin project. Use when you need to modify RGBA channels or source ID of an existing color after confirming the project and color IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `a` | number | No | Alpha (opacity) component of the color (0.0–1.0) |
| `b` | integer | No | Blue component of the color (0–255) |
| `g` | integer | No | Green component of the color (0–255) |
| `r` | integer | No | Red component of the color (0–255) |
| `color_id` | string | Yes | ID of the color to update |
| `source_id` | string | No | Optional identifier of the color in the source design tool |
| `project_id` | string | Yes | ID of the project containing the color to update |

#### 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 Zeplin Project by ID

**Slug:** `ZEPLIN_PROJECTS_GET`

Tool to get a Zeplin project by ID. Use when you need detailed info about a specific project after confirming its project_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | Unique ID of the Zeplin project. |

#### 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 |

### Invite Project Member

**Slug:** `ZEPLIN_PROJECTS_MEMBERS_INVITE`

Tool to invite a user to a Zeplin project. Use when you need to add a member by email or username to a project after obtaining the project ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role` | string ("owner" | "admin" | "editor" | "member" | "alien" | "user") | No | Role to assign to the user in the project; one of owner, admin, editor, member, alien, user |
| `handle` | string | Yes | Identifier of the user to invite; typically an email address or username |
| `project_id` | string | Yes | ID of the Zeplin project to invite the member into |

#### 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 Project Text Styles

**Slug:** `ZEPLIN_PROJECT_TEXT_STYLES_LIST`

Tool to list text styles in a Zeplin project. Use when you need to fetch typography tokens defined at the project level after obtaining the project ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of items to return per page (1-100) |
| `offset` | integer | No | Zero-based offset for pagination |
| `project_id` | string | Yes | ID of the target project |
| `token_type` | string | No | Token type for Authorization header, typically 'Bearer' |
| `access_token` | string | No | Access token value to include in Authorization header |
| `authorization` | string | No | Full Authorization header value. If provided, overrides token_type/access_token |

#### 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 Text Style

**Slug:** `ZEPLIN_PROJECT_TEXT_STYLE_UPDATE`

Tool to update a text style in a Zeplin project. Use when you need to modify typography settings of an existing text style after confirming the project and text style IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Fields to update on the text style |
| `project_id` | string | Yes | ID of the project containing the text style |
| `token_type` | string | No | Overrides stored token type (e.g., 'Bearer') |
| `access_token` | string | No | Overrides stored access token |
| `authorization` | string | No | Full Authorization header value. Overrides token_type/access_token if provided |
| `text_style_id` | string | Yes | ID of the text style to update |

#### 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 Screen Annotation

**Slug:** `ZEPLIN_SCREEN_ANNOTATION_DELETE`

Tool to delete a screen annotation in Zeplin. Use when you need to remove a specific annotation from a Zeplin screen given its IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `screen_id` | string | Yes | ID of the Zeplin screen containing the annotation. |
| `annotation_id` | string | Yes | ID of the screen annotation to 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 Screen Annotation

**Slug:** `ZEPLIN_SCREEN_ANNOTATION_GET`

Tool to fetch a single screen annotation. Use when you know the screen_id and annotation_id and need the detailed annotation data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `screen_id` | string | Yes | Unique ID of the Zeplin screen containing the annotation. |
| `annotation_id` | string | Yes | Unique ID of the screen annotation to retrieve. |

#### 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 Screen Annotations

**Slug:** `ZEPLIN_SCREEN_ANNOTATIONS_LIST`

Tool to list annotations for a Zeplin screen. Use when you have the screen_id and need its annotations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of annotations to return per page (1-100) |
| `offset` | integer | No | Zero-based offset for pagination |
| `screen_id` | string | Yes | Unique ID of the Zeplin screen to list annotations for |

#### 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 Screen Annotation

**Slug:** `ZEPLIN_SCREEN_ANNOTATIONS_UPDATE`

Tool to update a screen annotation's content, position, or type. Use after confirming screen_id and annotation_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | object | No | Type identifier for a screen annotation note type. |
| `content` | string | No | New text/content for the annotation |
| `position` | object | No | Normalized position of a screen annotation. |
| `screen_id` | string | Yes | ID of the Zeplin screen containing the annotation |
| `annotation_id` | string | Yes | ID of the annotation to update |

#### 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 Screen Components

**Slug:** `ZEPLIN_SCREEN_COMPONENTS_LIST`

Tool to list components in a Zeplin screen. Use when you have the screen_id and need to retrieve UI components in a specific screen.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of components to return per page (1-100) |
| `offset` | integer | No | Zero-based offset for pagination |
| `screen_id` | string | Yes | Unique ID of the Zeplin screen to list components for |
| `include_latest_version` | boolean | No | Whether to include latest_version data for each component |

#### 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 Screen Section

**Slug:** `ZEPLIN_SCREEN_SECTION_GET`

Tool to get a single screen section. Use when you need to fetch detailed information of a screen section by its ID after confirming the project and section IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | Yes | Unique ID of the Zeplin project containing the section. |
| `section_id` | string | Yes | Unique ID of the screen section to retrieve. |

#### 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 Screen Sections

**Slug:** `ZEPLIN_SCREEN_SECTIONS_LIST`

Tool to list screen sections in a Zeplin project. Use when you need a paginated list of screen sections after confirming the project ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of screen sections to return per page (1-100). |
| `offset` | integer | No | Zero-based offset to start returning screen sections. |
| `project_id` | string | Yes | Unique ID of the Zeplin project to list screen sections for |

#### 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 Screen Version

**Slug:** `ZEPLIN_SCREEN_VERSION_GET`

Tool to retrieve a specific screen version. Use after specifying both screen_id and version_id when you need detailed snapshot metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `screen_id` | string | Yes | Unique ID of the Zeplin screen containing the version. |
| `version_id` | string | Yes | Unique ID of the specific screen version to retrieve. |

#### 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 Screen Version

**Slug:** `ZEPLIN_SCREEN_VERSIONS_CREATE`

Tool to create a new version of a screen. Use when uploading a new design snapshot (PNG or JPEG image) as a screen version. Requires a valid project_id, screen_id, and an image file. Optionally include a commit_message.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `image` | object | Yes | Image file to upload as the new screen version. Supported formats: PNG, JPEG. |
| `screen_id` | string | Yes | Unique ID of the screen to create a new version for. |
| `project_id` | string | Yes | Unique ID of the Zeplin project containing the screen. |
| `commit_message` | string | No | Descriptive message for the screen version commit. |

#### 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 Screen Versions

**Slug:** `ZEPLIN_SCREEN_VERSIONS_LIST`

Tool to list all versions of a screen. Use when you need to enumerate past screen snapshots after obtaining a screen ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of versions to return per page (1-100) |
| `offset` | integer | No | Zero-based index of the first version to return |
| `screen_id` | string | Yes | Unique ID of the Zeplin screen to list versions for |

#### 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 Styleguide Color

**Slug:** `ZEPLIN_STYLEGUIDE_COLOR_CREATE`

Tool to create a new styleguide color. Use after obtaining the styleguide ID to define custom color tokens.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `a` | number | Yes | Alpha channel value (0–1) |
| `b` | integer | Yes | Blue channel value (0–255) |
| `g` | integer | Yes | Green channel value (0–255) |
| `r` | integer | Yes | Red channel value (0–255) |
| `name` | string | Yes | Name of the color |
| `token_type` | string | No | Token type for Authorization header, typically 'Bearer' |
| `access_token` | string | No | Access token value to include in Authorization header |
| `authorization` | string | No | Full Authorization header value. If provided, overrides token_type/access_token |
| `styleguide_id` | string | Yes | ID of the target styleguide |

#### 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 Styleguide Colors

**Slug:** `ZEPLIN_STYLEGUIDE_COLORS_LIST`

Tool to list colors in a Zeplin styleguide. Use when you need to fetch defined color tokens after obtaining the styleguide ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `token_type` | string | No | Token type for Authorization header, typically 'Bearer' |
| `access_token` | string | No | Access token value to include in Authorization header |
| `authorization` | string | No | Full Authorization header value. If provided, overrides token_type/access_token |
| `styleguide_id` | string | Yes | ID of the target styleguide |
| `linked_project` | string | No | Optional project ID to grant access when requester may not be authorized to view the styleguide |

#### 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 Styleguide Color

**Slug:** `ZEPLIN_STYLEGUIDE_COLOR_UPDATE`

Tool to update a color in a Zeplin styleguide. Use after obtaining the styleguide and color IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `a` | number | No | Alpha component (0.0–1.0) |
| `b` | integer | No | Blue component (0–255) |
| `g` | integer | No | Green component (0–255) |
| `r` | integer | No | Red component (0–255) |
| `name` | string | No | Name of the color |
| `color_id` | string | Yes | ID of the color to update |
| `source_id` | string | No | Design tool/source identifier of the color |
| `token_type` | string | No | Token type to use in Authorization header, typically 'Bearer' |
| `access_token` | string | No | Access token value for Authorization header |
| `authorization` | string | No | Full Authorization header value (e.g., 'Bearer x.y.z'). Overrides token_type/access_token if provided |
| `styleguide_id` | string | Yes | ID of the styleguide containing the color |

#### 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 Styleguide Text Styles

**Slug:** `ZEPLIN_STYLEGUIDE_TEXT_STYLES_LIST`

Tool to list text styles in a Zeplin styleguide. Use when you need to fetch defined typography tokens after obtaining the styleguide ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of items to return per page (1-100) |
| `offset` | integer | No | Zero-based offset for pagination |
| `token_type` | string | No | Token type for Authorization header, typically 'Bearer' |
| `access_token` | string | No | Access token value to include in Authorization header |
| `authorization` | string | No | Full Authorization header value. If provided, overrides token_type/access_token |
| `styleguide_id` | string | Yes | ID of the target styleguide |
| `linked_project` | string | No | Optional project ID to filter linked text styles |

#### 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 Styleguide Text Style

**Slug:** `ZEPLIN_STYLEGUIDE_TEXT_STYLE_UPDATE`

Tool to update a text style in a Zeplin styleguide. Use when you need to modify typography settings of an existing text style after confirming the styleguide and text style IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Fields to update on the text style |
| `token_type` | string | No | Overrides stored token type (e.g., 'Bearer') |
| `access_token` | string | No | Overrides stored access token |
| `authorization` | string | No | Full Authorization header value. Overrides token_type/access_token if provided |
| `styleguide_id` | string | Yes | ID of the styleguide containing the text style |
| `text_style_id` | string | Yes | ID of the text style to update |

#### 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 Personal Projects

**Slug:** `ZEPLIN_USERS_GET_PERSONAL_PROJECTS`

Tool to list personal projects. Use when you need to fetch all projects in the current user's personal workspace after authentication.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of items to return; default 30; maximum 100. |
| `offset` | integer | No | Zero-based starting index; default 0. |

#### 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 |