> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# penpot-design

> Penpot Design - manage files, projects, pages, libraries, and snapshots

**Server path:** `/penpot-design` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                              | Description                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`penpot_design_clone_template`](#penpot_design_clone_template)                                   | Clone into the specified project the template by its id.                                                                                                                                                                                                                                                                                                                                           |
| [`penpot_design_create_file`](#penpot_design_create_file)                                         | POST create-file                                                                                                                                                                                                                                                                                                                                                                                   |
| [`penpot_design_create_file_snapshot`](#penpot_design_create_file_snapshot)                       | POST create-file-snapshot                                                                                                                                                                                                                                                                                                                                                                          |
| [`penpot_design_create_project`](#penpot_design_create_project)                                   | POST create-project                                                                                                                                                                                                                                                                                                                                                                                |
| [`penpot_design_delete_file`](#penpot_design_delete_file)                                         | POST delete-file                                                                                                                                                                                                                                                                                                                                                                                   |
| [`penpot_design_delete_file_snapshot`](#penpot_design_delete_file_snapshot)                       | POST delete-file-snapshot                                                                                                                                                                                                                                                                                                                                                                          |
| [`penpot_design_delete_project`](#penpot_design_delete_project)                                   | POST delete-project                                                                                                                                                                                                                                                                                                                                                                                |
| [`penpot_design_duplicate_file`](#penpot_design_duplicate_file)                                   | Duplicate a single file in the same team.                                                                                                                                                                                                                                                                                                                                                          |
| [`penpot_design_duplicate_project`](#penpot_design_duplicate_project)                             | Duplicate an entire project with all the files                                                                                                                                                                                                                                                                                                                                                     |
| [`penpot_design_get_all_projects`](#penpot_design_get_all_projects)                               | POST get-all-projects                                                                                                                                                                                                                                                                                                                                                                              |
| [`penpot_design_get_file`](#penpot_design_get_file)                                               | Retrieve a file by its ID. Only authenticated users.                                                                                                                                                                                                                                                                                                                                               |
| [`penpot_design_get_file_info`](#penpot_design_get_file_info)                                     | Retrieve minimal file info by its ID.                                                                                                                                                                                                                                                                                                                                                              |
| [`penpot_design_get_file_libraries`](#penpot_design_get_file_libraries)                           | Get libraries used by the specified file.                                                                                                                                                                                                                                                                                                                                                          |
| [`penpot_design_get_file_snapshots`](#penpot_design_get_file_snapshots)                           | POST get-file-snapshots                                                                                                                                                                                                                                                                                                                                                                            |
| [`penpot_design_get_file_summary`](#penpot_design_get_file_summary)                               | Retrieve a file summary by its ID. Only authenticated users.                                                                                                                                                                                                                                                                                                                                       |
| [`penpot_design_get_library_file_references`](#penpot_design_get_library_file_references)         | Returns all the file references that use specified file (library) id.                                                                                                                                                                                                                                                                                                                              |
| [`penpot_design_get_library_usage`](#penpot_design_get_library_usage)                             | Gets the number of files that use the specified library.                                                                                                                                                                                                                                                                                                                                           |
| [`penpot_design_get_page`](#penpot_design_get_page)                                               | Retrieves the page data from file and returns it. If no page-id is specified, the first page will be returned. If object-id is specified, only that object and its children will be returned in the page objects data structure.  If you specify the object-id, the page-id parameter becomes mandatory.  Mainly used for rendering purposes on the exporter. It does not accepts client features. |
| [`penpot_design_get_project`](#penpot_design_get_project)                                         | POST get-project                                                                                                                                                                                                                                                                                                                                                                                   |
| [`penpot_design_get_project_files`](#penpot_design_get_project_files)                             | Get all files for the specified project.                                                                                                                                                                                                                                                                                                                                                           |
| [`penpot_design_get_projects`](#penpot_design_get_projects)                                       | POST get-projects                                                                                                                                                                                                                                                                                                                                                                                  |
| [`penpot_design_get_team_deleted_files`](#penpot_design_get_team_deleted_files)                   | POST get-team-deleted-files                                                                                                                                                                                                                                                                                                                                                                        |
| [`penpot_design_get_team_recent_files`](#penpot_design_get_team_recent_files)                     | POST get-team-recent-files                                                                                                                                                                                                                                                                                                                                                                         |
| [`penpot_design_get_team_shared_files`](#penpot_design_get_team_shared_files)                     | Get all file (libraries) for the specified team.                                                                                                                                                                                                                                                                                                                                                   |
| [`penpot_design_has_file_libraries`](#penpot_design_has_file_libraries)                           | Checks if the file has libraries. Returns a boolean                                                                                                                                                                                                                                                                                                                                                |
| [`penpot_design_ignore_file_library_sync_status`](#penpot_design_ignore_file_library_sync_status) | Ignore updates in linked files                                                                                                                                                                                                                                                                                                                                                                     |
| [`penpot_design_link_file_to_library`](#penpot_design_link_file_to_library)                       | Link a file to a library. Returns the recursive list of libraries used by that library                                                                                                                                                                                                                                                                                                             |
| [`penpot_design_lock_file_snapshot`](#penpot_design_lock_file_snapshot)                           | POST lock-file-snapshot                                                                                                                                                                                                                                                                                                                                                                            |
| [`penpot_design_move_files`](#penpot_design_move_files)                                           | Move a set of files from one project to other.                                                                                                                                                                                                                                                                                                                                                     |
| [`penpot_design_move_project`](#penpot_design_move_project)                                       | Move projects between teams                                                                                                                                                                                                                                                                                                                                                                        |
| [`penpot_design_permanently_delete_team_files`](#penpot_design_permanently_delete_team_files)     | Mark the specified files to be deleted immediatelly on the specified team. The team-id on params will be used to filter and check writable permissons on team.                                                                                                                                                                                                                                     |
| [`penpot_design_rename_file`](#penpot_design_rename_file)                                         | POST rename-file                                                                                                                                                                                                                                                                                                                                                                                   |
| [`penpot_design_rename_project`](#penpot_design_rename_project)                                   | POST rename-project                                                                                                                                                                                                                                                                                                                                                                                |
| [`penpot_design_restore_deleted_team_files`](#penpot_design_restore_deleted_team_files)           | Removes the deletion mark from the specified files (and respective projects) on the specified team.                                                                                                                                                                                                                                                                                                |
| [`penpot_design_restore_file_snapshot`](#penpot_design_restore_file_snapshot)                     | POST restore-file-snapshot                                                                                                                                                                                                                                                                                                                                                                         |
| [`penpot_design_search_files`](#penpot_design_search_files)                                       | POST search-files                                                                                                                                                                                                                                                                                                                                                                                  |
| [`penpot_design_set_file_shared`](#penpot_design_set_file_shared)                                 | POST set-file-shared                                                                                                                                                                                                                                                                                                                                                                               |
| [`penpot_design_unlink_file_from_library`](#penpot_design_unlink_file_from_library)               | POST unlink-file-from-library                                                                                                                                                                                                                                                                                                                                                                      |
| [`penpot_design_unlock_file_snapshot`](#penpot_design_unlock_file_snapshot)                       | POST unlock-file-snapshot                                                                                                                                                                                                                                                                                                                                                                          |
| [`penpot_design_update_file`](#penpot_design_update_file)                                         | POST update-file                                                                                                                                                                                                                                                                                                                                                                                   |
| [`penpot_design_update_file_library_sync_status`](#penpot_design_update_file_library_sync_status) | Update the synchronization status of a file->library link                                                                                                                                                                                                                                                                                                                                          |
| [`penpot_design_update_file_snapshot`](#penpot_design_update_file_snapshot)                       | POST update-file-snapshot                                                                                                                                                                                                                                                                                                                                                                          |
| [`penpot_design_update_project_pin`](#penpot_design_update_project_pin)                           | POST update-project-pin                                                                                                                                                                                                                                                                                                                                                                            |

***

## penpot\_design\_clone\_template

Clone into the specified project the template by its id.

**Parameters:**

| Parameter    | Type   | Required | Default | Description           |
| ------------ | ------ | -------- | ------- | --------------------- |
| `projectId`  | string | Yes      | —       | UUID formatted string |
| `templateId` | string | Yes      | —       | string                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "projectId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "templateId": {
        "type": "string",
        "description": "string"
      }
    },
    "required": [
      "PCID",
      "projectId",
      "templateId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_create\_file

POST create-file

**Parameters:**

| Parameter   | Type      | Required | Default | Description           |
| ----------- | --------- | -------- | ------- | --------------------- |
| `features`  | string\[] | No       | —       | Set of Strings        |
| `id`        | string    | No       | —       | UUID formatted string |
| `isShared`  | boolean   | No       | —       | boolean               |
| `name`      | string    | Yes      | —       | The name value        |
| `projectId` | string    | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "features": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Set of Strings"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "isShared": {
        "type": "boolean",
        "description": "boolean"
      },
      "name": {
        "type": "string",
        "description": "The name value"
      },
      "projectId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "name",
      "projectId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_create\_file\_snapshot

POST create-file-snapshot

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `fileId`  | string | Yes      | —       | UUID formatted string |
| `label`   | string | No       | —       | The label value       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "label": {
        "type": "string",
        "description": "The label value"
      }
    },
    "required": [
      "PCID",
      "fileId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_create\_project

POST create-project

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | No       | —       | UUID formatted string |
| `name`    | string | Yes      | —       | The name value        |
| `teamId`  | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "name": {
        "type": "string",
        "description": "The name value"
      },
      "teamId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "name",
      "teamId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_delete\_file

POST delete-file

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_delete\_file\_snapshot

POST delete-file-snapshot

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_delete\_project

POST delete-project

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_duplicate\_file

Duplicate a single file in the same team.

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `fileId`  | string | Yes      | —       | UUID formatted string |
| `name`    | string | No       | —       | The name value        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "name": {
        "type": "string",
        "description": "The name value"
      }
    },
    "required": [
      "PCID",
      "fileId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_duplicate\_project

Duplicate an entire project with all the files

**Parameters:**

| Parameter   | Type   | Required | Default | Description           |
| ----------- | ------ | -------- | ------- | --------------------- |
| `name`      | string | No       | —       | The name value        |
| `projectId` | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "name": {
        "type": "string",
        "description": "The name value"
      },
      "projectId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "projectId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_all\_projects

POST get-all-projects

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_file

Retrieve a file by its ID. Only authenticated users.

**Parameters:**

| Parameter  | Type      | Required | Default | Description           |
| ---------- | --------- | -------- | ------- | --------------------- |
| `features` | string\[] | No       | —       | Set of Strings        |
| `id`       | string    | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "features": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Set of Strings"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_file\_info

Retrieve minimal file info by its ID.

**Parameters:**

| Parameter  | Type      | Required | Default | Description           |
| ---------- | --------- | -------- | ------- | --------------------- |
| `features` | string\[] | No       | —       | Set of Strings        |
| `id`       | string    | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "features": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Set of Strings"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_file\_libraries

Get libraries used by the specified file.

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `fileId`  | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "fileId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_file\_snapshots

POST get-file-snapshots

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `fileId`  | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "fileId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_file\_summary

Retrieve a file summary by its ID. Only authenticated users.

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_library\_file\_references

Returns all the file references that use specified file (library) id.

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `fileId`  | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "fileId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_library\_usage

Gets the number of files that use the specified library.

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `fileId`  | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "fileId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_page

Retrieves the page data from file and returns it. If no page-id is specified, the first page will be returned. If object-id is specified, only that object and its children will be returned in the page objects data structure.  If you specify the object-id, the page-id parameter becomes mandatory.  Mainly used for rendering purposes on the exporter. It does not accepts client features.

**Parameters:**

| Parameter  | Type      | Required | Default | Description           |
| ---------- | --------- | -------- | ------- | --------------------- |
| `features` | string\[] | No       | —       | Set of Strings        |
| `fileId`   | string    | Yes      | —       | UUID formatted string |
| `objectId` | string\[] | No       | —       | Set of Strings        |
| `pageId`   | string    | No       | —       | UUID formatted string |
| `shareId`  | string    | No       | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "features": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Set of Strings"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "objectId": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "description": "Set of Strings"
      },
      "pageId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "shareId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "fileId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_project

POST get-project

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_project\_files

Get all files for the specified project.

**Parameters:**

| Parameter   | Type   | Required | Default | Description           |
| ----------- | ------ | -------- | ------- | --------------------- |
| `projectId` | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "projectId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "projectId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_projects

POST get-projects

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `teamId`  | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "teamId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "teamId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_team\_deleted\_files

POST get-team-deleted-files

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `teamId`  | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "teamId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "teamId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_team\_recent\_files

POST get-team-recent-files

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `teamId`  | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "teamId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "teamId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_get\_team\_shared\_files

Get all file (libraries) for the specified team.

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `teamId`  | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "teamId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "teamId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_has\_file\_libraries

Checks if the file has libraries. Returns a boolean

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `fileId`  | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "fileId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_ignore\_file\_library\_sync\_status

Ignore updates in linked files

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `date`    | string | Yes      | —       | The date value        |
| `fileId`  | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "date": {
        "type": "string",
        "description": "The date value"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "date",
      "fileId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_link\_file\_to\_library

Link a file to a library. Returns the recursive list of libraries used by that library

**Parameters:**

| Parameter   | Type   | Required | Default | Description           |
| ----------- | ------ | -------- | ------- | --------------------- |
| `fileId`    | string | Yes      | —       | UUID formatted string |
| `libraryId` | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "libraryId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "fileId",
      "libraryId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_lock\_file\_snapshot

POST lock-file-snapshot

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_move\_files

Move a set of files from one project to other.

**Parameters:**

| Parameter   | Type      | Required | Default | Description           |
| ----------- | --------- | -------- | ------- | --------------------- |
| `ids`       | string\[] | Yes      | —       | Set of Strings        |
| `projectId` | string    | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "ids": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "description": "Set of Strings"
      },
      "projectId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "ids",
      "projectId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_move\_project

Move projects between teams

**Parameters:**

| Parameter   | Type   | Required | Default | Description           |
| ----------- | ------ | -------- | ------- | --------------------- |
| `projectId` | string | Yes      | —       | UUID formatted string |
| `teamId`    | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "projectId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "teamId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "projectId",
      "teamId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_permanently\_delete\_team\_files

Mark the specified files to be deleted immediatelly on the specified team. The team-id on params will be used to filter and check writable permissons on team.

**Parameters:**

| Parameter | Type      | Required | Default | Description           |
| --------- | --------- | -------- | ------- | --------------------- |
| `ids`     | string\[] | Yes      | —       | Set of Strings        |
| `teamId`  | string    | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "ids": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "description": "Set of Strings"
      },
      "teamId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "ids",
      "teamId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_rename\_file

POST rename-file

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |
| `name`    | string | Yes      | —       | The name value        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "name": {
        "type": "string",
        "description": "The name value"
      }
    },
    "required": [
      "PCID",
      "id",
      "name"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_rename\_project

POST rename-project

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |
| `name`    | string | Yes      | —       | The name value        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "name": {
        "type": "string",
        "description": "The name value"
      }
    },
    "required": [
      "PCID",
      "id",
      "name"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_restore\_deleted\_team\_files

Removes the deletion mark from the specified files (and respective projects) on the specified team.

**Parameters:**

| Parameter | Type      | Required | Default | Description           |
| --------- | --------- | -------- | ------- | --------------------- |
| `ids`     | string\[] | Yes      | —       | Set of Strings        |
| `teamId`  | string    | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "ids": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "description": "Set of Strings"
      },
      "teamId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "ids",
      "teamId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_restore\_file\_snapshot

POST restore-file-snapshot

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `fileId`  | string | Yes      | —       | UUID formatted string |
| `id`      | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "fileId",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_search\_files

POST search-files

**Parameters:**

| Parameter    | Type   | Required | Default | Description                   |
| ------------ | ------ | -------- | ------- | ----------------------------- |
| `searchTerm` | string | No       | —       | Search term to filter results |
| `teamId`     | string | Yes      | —       | UUID formatted string         |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "searchTerm": {
        "type": "string",
        "description": "Search term to filter results"
      },
      "teamId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "teamId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_set\_file\_shared

POST set-file-shared

**Parameters:**

| Parameter  | Type    | Required | Default | Description           |
| ---------- | ------- | -------- | ------- | --------------------- |
| `id`       | string  | Yes      | —       | UUID formatted string |
| `isShared` | boolean | Yes      | —       | boolean               |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "isShared": {
        "type": "boolean",
        "description": "boolean"
      }
    },
    "required": [
      "PCID",
      "id",
      "isShared"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_unlink\_file\_from\_library

POST unlink-file-from-library

**Parameters:**

| Parameter   | Type   | Required | Default | Description           |
| ----------- | ------ | -------- | ------- | --------------------- |
| `fileId`    | string | Yes      | —       | UUID formatted string |
| `libraryId` | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "libraryId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "fileId",
      "libraryId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_unlock\_file\_snapshot

POST unlock-file-snapshot

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_update\_file

POST update-file

**Parameters:**

| Parameter             | Type      | Required | Default | Description           |
| --------------------- | --------- | -------- | ------- | --------------------- |
| `changes`             | any\[]    | No       | —       | The changes value     |
| `changesWithMetadata` | object\[] | No       | —       | Changes With Metadata |
| `features`            | string\[] | No       | —       | Set of Strings        |
| `id`                  | string    | Yes      | —       | UUID formatted string |
| `revn`                | integer   | Yes      | —       | integer               |
| `sessionId`           | string    | Yes      | —       | UUID formatted string |
| `skipValidate`        | boolean   | No       | —       | boolean               |
| `vern`                | integer   | Yes      | —       | integer               |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "changes": {
        "type": "array",
        "description": "The changes value"
      },
      "changesWithMetadata": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "changes": {
              "type": "array",
              "description": "The changes value"
            },
            "hintOrigin": {
              "type": "string",
              "description": "Hint Origin"
            },
            "hintEvents": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "Hint Events"
            }
          },
          "required": [
            "changes"
          ]
        },
        "description": "Changes With Metadata"
      },
      "features": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Set of Strings"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "revn": {
        "type": "integer",
        "description": "integer"
      },
      "sessionId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "skipValidate": {
        "type": "boolean",
        "description": "boolean"
      },
      "vern": {
        "type": "integer",
        "description": "integer"
      }
    },
    "required": [
      "PCID",
      "id",
      "revn",
      "sessionId",
      "vern"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_update\_file\_library\_sync\_status

Update the synchronization status of a file->library link

**Parameters:**

| Parameter   | Type   | Required | Default | Description           |
| ----------- | ------ | -------- | ------- | --------------------- |
| `fileId`    | string | Yes      | —       | UUID formatted string |
| `libraryId` | string | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "fileId": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "libraryId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "fileId",
      "libraryId"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_update\_file\_snapshot

POST update-file-snapshot

**Parameters:**

| Parameter | Type   | Required | Default | Description           |
| --------- | ------ | -------- | ------- | --------------------- |
| `id`      | string | Yes      | —       | UUID formatted string |
| `label`   | string | Yes      | —       | not whitespace string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "label": {
        "type": "string",
        "description": "not whitespace string"
      }
    },
    "required": [
      "PCID",
      "id",
      "label"
    ]
  }
  ```
</Expandable>

***

## penpot\_design\_update\_project\_pin

POST update-project-pin

**Parameters:**

| Parameter  | Type    | Required | Default | Description           |
| ---------- | ------- | -------- | ------- | --------------------- |
| `id`       | string  | Yes      | —       | UUID formatted string |
| `isPinned` | boolean | Yes      | —       | boolean               |
| `teamId`   | string  | Yes      | —       | UUID formatted string |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "UUID formatted string"
      },
      "isPinned": {
        "type": "boolean",
        "description": "boolean"
      },
      "teamId": {
        "type": "string",
        "description": "UUID formatted string"
      }
    },
    "required": [
      "PCID",
      "id",
      "isPinned",
      "teamId"
    ]
  }
  ```
</Expandable>