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

# shortcut-resources

> Shortcut Resources - manage documents, files, linked files, members, templates, and repositories

**Server path:** `/shortcut-resources` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                              | Description                |
| ------------------------------------------------------------------------------------------------- | -------------------------- |
| [`shortcut_resources_create_doc`](#shortcut_resources_create_doc)                                 | Create Doc                 |
| [`shortcut_resources_create_entity_template`](#shortcut_resources_create_entity_template)         | Create Entity Template     |
| [`shortcut_resources_create_generic_integration`](#shortcut_resources_create_generic_integration) | Create Generic Integration |
| [`shortcut_resources_create_linked_file`](#shortcut_resources_create_linked_file)                 | Create Linked File         |
| [`shortcut_resources_delete_doc`](#shortcut_resources_delete_doc)                                 | Delete Doc                 |
| [`shortcut_resources_delete_entity_template`](#shortcut_resources_delete_entity_template)         | Delete Entity Template     |
| [`shortcut_resources_delete_file`](#shortcut_resources_delete_file)                               | Delete File                |
| [`shortcut_resources_delete_generic_integration`](#shortcut_resources_delete_generic_integration) | Delete Generic Integration |
| [`shortcut_resources_delete_linked_file`](#shortcut_resources_delete_linked_file)                 | Delete Linked File         |
| [`shortcut_resources_disable_story_templates`](#shortcut_resources_disable_story_templates)       | Disable Story Templates    |
| [`shortcut_resources_enable_story_templates`](#shortcut_resources_enable_story_templates)         | Enable Story Templates     |
| [`shortcut_resources_get_current_member_info`](#shortcut_resources_get_current_member_info)       | Get Current Member Info    |
| [`shortcut_resources_get_doc`](#shortcut_resources_get_doc)                                       | Get Doc                    |
| [`shortcut_resources_get_entity_template`](#shortcut_resources_get_entity_template)               | Get Entity Template        |
| [`shortcut_resources_get_file`](#shortcut_resources_get_file)                                     | Get File                   |
| [`shortcut_resources_get_generic_integration`](#shortcut_resources_get_generic_integration)       | Get Generic Integration    |
| [`shortcut_resources_get_linked_file`](#shortcut_resources_get_linked_file)                       | Get Linked File            |
| [`shortcut_resources_get_member`](#shortcut_resources_get_member)                                 | Get Member                 |
| [`shortcut_resources_get_repository`](#shortcut_resources_get_repository)                         | Get Repository             |
| [`shortcut_resources_link_document_to_epic`](#shortcut_resources_link_document_to_epic)           | Link Document to Epic      |
| [`shortcut_resources_list_docs`](#shortcut_resources_list_docs)                                   | List Docs                  |
| [`shortcut_resources_list_document_epics`](#shortcut_resources_list_document_epics)               | List Document Epics        |
| [`shortcut_resources_list_entity_templates`](#shortcut_resources_list_entity_templates)           | List Entity Templates      |
| [`shortcut_resources_list_files`](#shortcut_resources_list_files)                                 | List Files                 |
| [`shortcut_resources_list_linked_files`](#shortcut_resources_list_linked_files)                   | List Linked Files          |
| [`shortcut_resources_list_members`](#shortcut_resources_list_members)                             | List Members               |
| [`shortcut_resources_list_repositories`](#shortcut_resources_list_repositories)                   | List Repositories          |
| [`shortcut_resources_unlink_document_from_epic`](#shortcut_resources_unlink_document_from_epic)   | Unlink Document from Epic  |
| [`shortcut_resources_update_doc`](#shortcut_resources_update_doc)                                 | Update Doc                 |
| [`shortcut_resources_update_entity_template`](#shortcut_resources_update_entity_template)         | Update Entity Template     |
| [`shortcut_resources_update_file`](#shortcut_resources_update_file)                               | Update File                |
| [`shortcut_resources_update_health`](#shortcut_resources_update_health)                           | Update Health              |
| [`shortcut_resources_update_linked_file`](#shortcut_resources_update_linked_file)                 | Update Linked File         |
| [`shortcut_resources_upload_files`](#shortcut_resources_upload_files)                             | Upload Files               |

***

## shortcut\_resources\_create\_doc

Create Doc

**Parameters:**

| Parameter        | Type   | Required | Default | Description                                                                                                                                                                                          |
| ---------------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `content`        | string | Yes      | —       | The content for the new document.                                                                                                                                                                    |
| `content_format` | string | No       | —       | Format of the content being sent. Defaults to 'html'. If 'markdown', content will be converted to HTML for storage. Storage is always HTML; this parameter just tells us what format you're sending. |
| `title`          | string | Yes      | —       | The title for the new document.                                                                                                                                                                      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "content": {
        "type": "string",
        "description": "The content for the new document."
      },
      "content_format": {
        "type": "string",
        "description": "Format of the content being sent. Defaults to 'html'. If 'markdown', content will be converted to HTML for storage. Storage is always HTML; this parameter just tells us what format you're sending.",
        "enum": [
          "markdown",
          "html"
        ]
      },
      "title": {
        "type": "string",
        "description": "The title for the new document."
      }
    },
    "required": [
      "PCID",
      "content",
      "title"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_create\_entity\_template

Create Entity Template

**Parameters:**

| Parameter        | Type   | Required | Default | Description                                        |
| ---------------- | ------ | -------- | ------- | -------------------------------------------------- |
| `author_id`      | string | No       | —       | The id of the user creating this template.         |
| `name`           | string | Yes      | —       | The name of the new entity template                |
| `story_contents` | object | Yes      | —       | A map of story attributes this template populates. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "author_id": {
        "type": "string",
        "description": "The id of the user creating this template."
      },
      "name": {
        "type": "string",
        "description": "The name of the new entity template"
      },
      "story_contents": {
        "type": "object",
        "description": "A map of story attributes this template populates.",
        "properties": {
          "description": {
            "type": "string",
            "description": "The description of the story."
          },
          "labels": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "An array of labels to be populated by the template."
          },
          "story_type": {
            "type": "string",
            "description": "The type of story (feature, bug, chore)."
          },
          "custom_fields": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "An array of maps specifying a CustomField ID and CustomFieldEnumValue ID that represents an assertion of some value for a CustomField."
          },
          "file_ids": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "An array of the attached file IDs to be populated."
          },
          "name": {
            "type": "string",
            "description": "The name of the story."
          },
          "epic_id": {
            "type": "integer",
            "description": "The ID of the epic the to be populated."
          },
          "external_links": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "An array of external links to be populated."
          },
          "sub_tasks": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "An array of maps specifying the sub-tasks to create and link to the story. Field only applicable when Sub-task feature is enabled."
          },
          "iteration_id": {
            "type": "integer",
            "description": "The ID of the iteration the to be populated."
          },
          "tasks": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "An array of tasks to be populated by the template."
          },
          "group_id": {
            "type": "string",
            "description": "The ID of the group to be populated."
          },
          "workflow_state_id": {
            "type": "integer",
            "description": "The ID of the workflow state to be populated."
          },
          "follower_ids": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "An array of UUIDs for any Members listed as Followers."
          },
          "owner_ids": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "An array of UUIDs of the owners of this story."
          },
          "estimate": {
            "type": "integer",
            "description": "The numeric point estimate to be populated."
          },
          "project_id": {
            "type": "integer",
            "description": "The ID of the project the story belongs to."
          },
          "linked_file_ids": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "An array of the linked file IDs to be populated."
          },
          "deadline": {
            "type": "string",
            "description": "The due date of the story."
          }
        }
      }
    },
    "required": [
      "PCID",
      "name",
      "story_contents"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_create\_generic\_integration

Create Generic Integration

**Parameters:**

| Parameter     | Type   | Required | Default | Description      |
| ------------- | ------ | -------- | ------- | ---------------- |
| `secret`      | string | No       | —       | The secret value |
| `webhook_url` | string | Yes      | —       | Webhook Url      |

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

***

## shortcut\_resources\_create\_linked\_file

Create Linked File

**Parameters:**

| Parameter       | Type    | Required | Default | Description                                                   |
| --------------- | ------- | -------- | ------- | ------------------------------------------------------------- |
| `content_type`  | string  | No       | —       | The content type of the image (e.g. txt/plain).               |
| `description`   | string  | No       | —       | The description of the file.                                  |
| `name`          | string  | Yes      | —       | The name of the file.                                         |
| `size`          | integer | No       | —       | The filesize, if the integration provided it.                 |
| `story_id`      | integer | No       | —       | The ID of the linked story.                                   |
| `thumbnail_url` | string  | No       | —       | The URL of the thumbnail, if the integration provided it.     |
| `type`          | string  | Yes      | —       | The integration type of the file (e.g. google, dropbox, box). |
| `uploader_id`   | string  | No       | —       | The UUID of the member that uploaded the file.                |
| `url`           | string  | Yes      | —       | The URL of linked file.                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "content_type": {
        "type": "string",
        "description": "The content type of the image (e.g. txt/plain)."
      },
      "description": {
        "type": "string",
        "description": "The description of the file."
      },
      "name": {
        "type": "string",
        "description": "The name of the file."
      },
      "size": {
        "type": "integer",
        "description": "The filesize, if the integration provided it."
      },
      "story_id": {
        "type": "integer",
        "description": "The ID of the linked story."
      },
      "thumbnail_url": {
        "type": "string",
        "description": "The URL of the thumbnail, if the integration provided it."
      },
      "type": {
        "type": "string",
        "description": "The integration type of the file (e.g. google, dropbox, box).",
        "enum": [
          "google",
          "url",
          "dropbox",
          "box",
          "onedrive"
        ]
      },
      "uploader_id": {
        "type": "string",
        "description": "The UUID of the member that uploaded the file."
      },
      "url": {
        "type": "string",
        "description": "The URL of linked file."
      }
    },
    "required": [
      "PCID",
      "name",
      "type",
      "url"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_delete\_doc

Delete Doc

**Parameters:**

| Parameter        | Type   | Required | Default | Description                                                                                            |
| ---------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------ |
| `doc-public-id`  | string | Yes      | —       | The Doc's public ID                                                                                    |
| `content_format` | string | No       | —       | Format of the content to return. Defaults to 'markdown'. If 'html', includes HTML content in response. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "doc-public-id": {
        "type": "string",
        "description": "The Doc's public ID"
      },
      "content_format": {
        "type": "string",
        "description": "Format of the content to return. Defaults to 'markdown'. If 'html', includes HTML content in response.",
        "enum": [
          "markdown",
          "html"
        ]
      }
    },
    "required": [
      "PCID",
      "doc-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_delete\_entity\_template

Delete Entity Template

**Parameters:**

| Parameter                   | Type   | Required | Default | Description                           |
| --------------------------- | ------ | -------- | ------- | ------------------------------------- |
| `entity-template-public-id` | string | Yes      | —       | The unique ID of the entity template. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "entity-template-public-id": {
        "type": "string",
        "description": "The unique ID of the entity template."
      }
    },
    "required": [
      "PCID",
      "entity-template-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_delete\_file

Delete File

**Parameters:**

| Parameter        | Type    | Required | Default | Description           |
| ---------------- | ------- | -------- | ------- | --------------------- |
| `file-public-id` | integer | Yes      | —       | The File’s unique ID. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "file-public-id": {
        "type": "integer",
        "description": "The File’s unique ID."
      }
    },
    "required": [
      "PCID",
      "file-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_delete\_generic\_integration

Delete Generic Integration

**Parameters:**

| Parameter               | Type    | Required | Default | Description                     |
| ----------------------- | ------- | -------- | ------- | ------------------------------- |
| `integration-public-id` | integer | Yes      | —       | The integration-public-id value |

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

***

## shortcut\_resources\_delete\_linked\_file

Delete Linked File

**Parameters:**

| Parameter               | Type    | Required | Default | Description                               |
| ----------------------- | ------- | -------- | ------- | ----------------------------------------- |
| `linked-file-public-id` | integer | Yes      | —       | The unique identifier of the linked file. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "linked-file-public-id": {
        "type": "integer",
        "description": "The unique identifier of the linked file."
      }
    },
    "required": [
      "PCID",
      "linked-file-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_disable\_story\_templates

Disable Story Templates

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

***

## shortcut\_resources\_enable\_story\_templates

Enable Story Templates

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

***

## shortcut\_resources\_get\_current\_member\_info

Get Current Member Info

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

***

## shortcut\_resources\_get\_doc

Get Doc

**Parameters:**

| Parameter        | Type   | Required | Default | Description                                                                                            |
| ---------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------ |
| `doc-public-id`  | string | Yes      | —       | The Doc's public ID                                                                                    |
| `content_format` | string | No       | —       | Format of the content to return. Defaults to 'markdown'. If 'html', includes HTML content in response. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "doc-public-id": {
        "type": "string",
        "description": "The Doc's public ID"
      },
      "content_format": {
        "type": "string",
        "description": "Format of the content to return. Defaults to 'markdown'. If 'html', includes HTML content in response.",
        "enum": [
          "markdown",
          "html"
        ]
      }
    },
    "required": [
      "PCID",
      "doc-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_get\_entity\_template

Get Entity Template

**Parameters:**

| Parameter                   | Type   | Required | Default | Description                           |
| --------------------------- | ------ | -------- | ------- | ------------------------------------- |
| `entity-template-public-id` | string | Yes      | —       | The unique ID of the entity template. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "entity-template-public-id": {
        "type": "string",
        "description": "The unique ID of the entity template."
      }
    },
    "required": [
      "PCID",
      "entity-template-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_get\_file

Get File

**Parameters:**

| Parameter        | Type    | Required | Default | Description           |
| ---------------- | ------- | -------- | ------- | --------------------- |
| `file-public-id` | integer | Yes      | —       | The File’s unique ID. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "file-public-id": {
        "type": "integer",
        "description": "The File’s unique ID."
      }
    },
    "required": [
      "PCID",
      "file-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_get\_generic\_integration

Get Generic Integration

**Parameters:**

| Parameter               | Type    | Required | Default | Description                     |
| ----------------------- | ------- | -------- | ------- | ------------------------------- |
| `integration-public-id` | integer | Yes      | —       | The integration-public-id value |

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

***

## shortcut\_resources\_get\_linked\_file

Get Linked File

**Parameters:**

| Parameter               | Type    | Required | Default | Description                               |
| ----------------------- | ------- | -------- | ------- | ----------------------------------------- |
| `linked-file-public-id` | integer | Yes      | —       | The unique identifier of the linked file. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "linked-file-public-id": {
        "type": "integer",
        "description": "The unique identifier of the linked file."
      }
    },
    "required": [
      "PCID",
      "linked-file-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_get\_member

Get Member

**Parameters:**

| Parameter          | Type   | Required | Default | Description                                               |
| ------------------ | ------ | -------- | ------- | --------------------------------------------------------- |
| `member-public-id` | string | Yes      | —       | The Member's unique ID.                                   |
| `org-public-id`    | string | No       | —       | The unique ID of the Organization to limit the lookup to. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "member-public-id": {
        "type": "string",
        "description": "The Member's unique ID."
      },
      "org-public-id": {
        "type": "string",
        "description": "The unique ID of the Organization to limit the lookup to."
      }
    },
    "required": [
      "PCID",
      "member-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_get\_repository

Get Repository

**Parameters:**

| Parameter        | Type    | Required | Default | Description                      |
| ---------------- | ------- | -------- | ------- | -------------------------------- |
| `repo-public-id` | integer | Yes      | —       | The unique ID of the Repository. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "repo-public-id": {
        "type": "integer",
        "description": "The unique ID of the Repository."
      }
    },
    "required": [
      "PCID",
      "repo-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_link\_document\_to\_epic

Link Document to Epic

**Parameters:**

| Parameter        | Type    | Required | Default | Description                    |
| ---------------- | ------- | -------- | ------- | ------------------------------ |
| `doc-public-id`  | string  | Yes      | —       | The public ID of the Document. |
| `epic-public-id` | integer | Yes      | —       | The public ID of the Epic.     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "doc-public-id": {
        "type": "string",
        "description": "The public ID of the Document."
      },
      "epic-public-id": {
        "type": "integer",
        "description": "The public ID of the Epic."
      }
    },
    "required": [
      "PCID",
      "doc-public-id",
      "epic-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_list\_docs

List Docs

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

***

## shortcut\_resources\_list\_document\_epics

List Document Epics

**Parameters:**

| Parameter       | Type   | Required | Default | Description                    |
| --------------- | ------ | -------- | ------- | ------------------------------ |
| `doc-public-id` | string | Yes      | —       | The public ID of the Document. |

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

***

## shortcut\_resources\_list\_entity\_templates

List Entity Templates

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

***

## shortcut\_resources\_list\_files

List Files

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

***

## shortcut\_resources\_list\_linked\_files

List Linked Files

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

***

## shortcut\_resources\_list\_members

List Members

**Parameters:**

| Parameter       | Type    | Required | Default | Description                                                                                                           |
| --------------- | ------- | -------- | ------- | --------------------------------------------------------------------------------------------------------------------- |
| `org-public-id` | string  | No       | —       | The unique ID of the Organization to limit the list to.                                                               |
| `disabled`      | boolean | No       | —       | Filter members by their disabled state. If true, return only disabled members. If false, return only enabled members. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "org-public-id": {
        "type": "string",
        "description": "The unique ID of the Organization to limit the list to."
      },
      "disabled": {
        "type": "boolean",
        "description": "Filter members by their disabled state. If true, return only disabled members. If false, return only enabled members."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_list\_repositories

List Repositories

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

***

## shortcut\_resources\_unlink\_document\_from\_epic

Unlink Document from Epic

**Parameters:**

| Parameter        | Type    | Required | Default | Description                    |
| ---------------- | ------- | -------- | ------- | ------------------------------ |
| `doc-public-id`  | string  | Yes      | —       | The public ID of the Document. |
| `epic-public-id` | integer | Yes      | —       | The public ID of the Epic.     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "doc-public-id": {
        "type": "string",
        "description": "The public ID of the Document."
      },
      "epic-public-id": {
        "type": "integer",
        "description": "The public ID of the Epic."
      }
    },
    "required": [
      "PCID",
      "doc-public-id",
      "epic-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_update\_doc

Update Doc

**Parameters:**

| Parameter        | Type   | Required | Default | Description                                                                                                                                                                             |
| ---------------- | ------ | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `doc-public-id`  | string | Yes      | —       | The Doc's public ID                                                                                                                                                                     |
| `content`        | string | No       | —       | The new content for the document.                                                                                                                                                       |
| `content_format` | string | No       | —       | Format of content. For input: specifies format of provided content (defaults to 'html'). For output: controls response format - 'markdown' (default) or 'html' to include HTML content. |
| `title`          | string | No       | —       | The new title for the document                                                                                                                                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "doc-public-id": {
        "type": "string",
        "description": "The Doc's public ID"
      },
      "content": {
        "type": "string",
        "description": "The new content for the document."
      },
      "content_format": {
        "type": "string",
        "description": "Format of content. For input: specifies format of provided content (defaults to 'html'). For output: controls response format - 'markdown' (default) or 'html' to include HTML content.",
        "enum": [
          "markdown",
          "html"
        ]
      },
      "title": {
        "type": "string",
        "description": "The new title for the document"
      }
    },
    "required": [
      "PCID",
      "doc-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_update\_entity\_template

Update Entity Template

**Parameters:**

| Parameter                   | Type   | Required | Default | Description                                      |
| --------------------------- | ------ | -------- | ------- | ------------------------------------------------ |
| `entity-template-public-id` | string | Yes      | —       | The unique ID of the template to be updated.     |
| `name`                      | string | No       | —       | The updated template name.                       |
| `story_contents`            | object | No       | —       | Updated attributes for the template to populate. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "entity-template-public-id": {
        "type": "string",
        "description": "The unique ID of the template to be updated."
      },
      "name": {
        "type": "string",
        "description": "The updated template name."
      },
      "story_contents": {
        "type": "object",
        "description": "Updated attributes for the template to populate.",
        "properties": {
          "description": {
            "type": "string",
            "description": "The description of the story."
          },
          "labels": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "An array of labels to be populated by the template."
          },
          "story_type": {
            "type": "string",
            "description": "The type of story (feature, bug, chore)."
          },
          "custom_fields": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "An array of maps specifying a CustomField ID and CustomFieldEnumValue ID that represents an assertion of some value for a CustomField."
          },
          "file_ids": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "An array of the attached file IDs to be populated."
          },
          "name": {
            "type": "string",
            "description": "The name of the story."
          },
          "epic_id": {
            "type": "integer",
            "description": "The ID of the epic the to be populated."
          },
          "external_links": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "An array of external links to be populated."
          },
          "sub_tasks": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "An array of maps specifying the sub-tasks to create and link to the story. Field only applicable when Sub-task feature is enabled."
          },
          "iteration_id": {
            "type": "integer",
            "description": "The ID of the iteration the to be populated."
          },
          "tasks": {
            "type": "array",
            "items": {
              "type": "object"
            },
            "description": "An array of tasks to be populated by the template."
          },
          "group_id": {
            "type": "string",
            "description": "The ID of the group to be populated."
          },
          "workflow_state_id": {
            "type": "integer",
            "description": "The ID of the workflow state to be populated."
          },
          "follower_ids": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "An array of UUIDs for any Members listed as Followers."
          },
          "owner_ids": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "An array of UUIDs of the owners of this story."
          },
          "estimate": {
            "type": "integer",
            "description": "The numeric point estimate to be populated."
          },
          "project_id": {
            "type": "integer",
            "description": "The ID of the project the story belongs to."
          },
          "linked_file_ids": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            },
            "description": "An array of the linked file IDs to be populated."
          },
          "deadline": {
            "type": "string",
            "description": "The due date of the story."
          }
        }
      }
    },
    "required": [
      "PCID",
      "entity-template-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_update\_file

Update File

**Parameters:**

| Parameter        | Type    | Required | Default | Description                                                             |
| ---------------- | ------- | -------- | ------- | ----------------------------------------------------------------------- |
| `file-public-id` | integer | Yes      | —       | The unique ID assigned to the file in Shortcut.                         |
| `created_at`     | string  | No       | —       | The time/date that the file was uploaded.                               |
| `description`    | string  | No       | —       | The description of the file.                                            |
| `external_id`    | string  | No       | —       | An additional ID that you may wish to assign to the file.               |
| `name`           | string  | No       | —       | The name of the file.                                                   |
| `updated_at`     | string  | No       | —       | The time/date that the file was last updated.                           |
| `uploader_id`    | string  | No       | —       | The unique ID assigned to the Member who uploaded the file to Shortcut. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "file-public-id": {
        "type": "integer",
        "description": "The unique ID assigned to the file in Shortcut."
      },
      "created_at": {
        "type": "string",
        "description": "The time/date that the file was uploaded."
      },
      "description": {
        "type": "string",
        "description": "The description of the file."
      },
      "external_id": {
        "type": "string",
        "description": "An additional ID that you may wish to assign to the file."
      },
      "name": {
        "type": "string",
        "description": "The name of the file."
      },
      "updated_at": {
        "type": "string",
        "description": "The time/date that the file was last updated."
      },
      "uploader_id": {
        "type": "string",
        "description": "The unique ID assigned to the Member who uploaded the file to Shortcut."
      }
    },
    "required": [
      "PCID",
      "file-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_update\_health

Update Health

**Parameters:**

| Parameter          | Type   | Required | Default | Description                           |
| ------------------ | ------ | -------- | ------- | ------------------------------------- |
| `health-public-id` | string | Yes      | —       | The unique ID of the Health record.   |
| `status`           | string | No       | —       | The health status of the Epic.        |
| `text`             | string | No       | —       | The description of the Health status. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "health-public-id": {
        "type": "string",
        "description": "The unique ID of the Health record."
      },
      "status": {
        "type": "string",
        "description": "The health status of the Epic.",
        "enum": [
          "At Risk",
          "On Track",
          "Off Track",
          "No Health"
        ]
      },
      "text": {
        "type": "string",
        "description": "The description of the Health status."
      }
    },
    "required": [
      "PCID",
      "health-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_update\_linked\_file

Update Linked File

**Parameters:**

| Parameter               | Type    | Required | Default | Description                                                   |
| ----------------------- | ------- | -------- | ------- | ------------------------------------------------------------- |
| `linked-file-public-id` | integer | Yes      | —       | The unique identifier of the linked file.                     |
| `description`           | string  | No       | —       | The description of the file.                                  |
| `name`                  | string  | No       | —       | The name of the file.                                         |
| `size`                  | integer | No       | —       | The filesize, if the integration provided it.                 |
| `story_id`              | integer | No       | —       | The ID of the linked story.                                   |
| `thumbnail_url`         | string  | No       | —       | The URL of the thumbnail, if the integration provided it.     |
| `type`                  | string  | No       | —       | The integration type of the file (e.g. google, dropbox, box). |
| `uploader_id`           | string  | No       | —       | The UUID of the member that uploaded the file.                |
| `url`                   | string  | No       | —       | The URL of linked file.                                       |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "linked-file-public-id": {
        "type": "integer",
        "description": "The unique identifier of the linked file."
      },
      "description": {
        "type": "string",
        "description": "The description of the file."
      },
      "name": {
        "type": "string",
        "description": "The name of the file."
      },
      "size": {
        "type": "integer",
        "description": "The filesize, if the integration provided it."
      },
      "story_id": {
        "type": "integer",
        "description": "The ID of the linked story."
      },
      "thumbnail_url": {
        "type": "string",
        "description": "The URL of the thumbnail, if the integration provided it."
      },
      "type": {
        "type": "string",
        "description": "The integration type of the file (e.g. google, dropbox, box).",
        "enum": [
          "google",
          "url",
          "dropbox",
          "box",
          "onedrive"
        ]
      },
      "uploader_id": {
        "type": "string",
        "description": "The UUID of the member that uploaded the file."
      },
      "url": {
        "type": "string",
        "description": "The URL of linked file."
      }
    },
    "required": [
      "PCID",
      "linked-file-public-id"
    ]
  }
  ```
</Expandable>

***

## shortcut\_resources\_upload\_files

Upload Files

**Parameters:**

| Parameter  | Type    | Required | Default | Description                                            |
| ---------- | ------- | -------- | ------- | ------------------------------------------------------ |
| `file0`    | string  | Yes      | —       | A file upload. At least one is required.               |
| `file1`    | string  | No       | —       | Optional additional files.                             |
| `file2`    | string  | No       | —       | Optional additional files.                             |
| `file3`    | string  | No       | —       | Optional additional files.                             |
| `story_id` | integer | No       | —       | The story ID that these files will be associated with. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "file0": {
        "type": "string",
        "description": "A file upload. At least one is required."
      },
      "file1": {
        "type": "string",
        "description": "Optional additional files."
      },
      "file2": {
        "type": "string",
        "description": "Optional additional files."
      },
      "file3": {
        "type": "string",
        "description": "Optional additional files."
      },
      "story_id": {
        "type": "integer",
        "description": "The story ID that these files will be associated with."
      }
    },
    "required": [
      "PCID",
      "file0"
    ]
  }
  ```
</Expandable>