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

# gist-conversations

> Gist Conversations - manage conversations, messages, assignments, teams, and teammates

**Server path:** `/gist-conversations` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                                          | Description                                      |
| ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| [`gist_conversations_assign_conversation`](#gist_conversations_assign_conversation)                           | Assign or unassign a conversation                |
| [`gist_conversations_create_conversation`](#gist_conversations_create_conversation)                           | Create a new conversation                        |
| [`gist_conversations_delete_conversation`](#gist_conversations_delete_conversation)                           | Delete a conversation                            |
| [`gist_conversations_get_conversation`](#gist_conversations_get_conversation)                                 | Retrieve a conversation                          |
| [`gist_conversations_get_conversation_counts`](#gist_conversations_get_conversation_counts)                   | Get global conversation counts                   |
| [`gist_conversations_get_team`](#gist_conversations_get_team)                                                 | Retrieve a team                                  |
| [`gist_conversations_get_team_conversation_counts`](#gist_conversations_get_team_conversation_counts)         | Get conversation counts by team                  |
| [`gist_conversations_get_teammate`](#gist_conversations_get_teammate)                                         | Retrieve a teammate                              |
| [`gist_conversations_get_teammate_conversation_counts`](#gist_conversations_get_teammate_conversation_counts) | Get conversation counts by teammate              |
| [`gist_conversations_get_workspace_meta`](#gist_conversations_get_workspace_meta)                             | Retrieve workspace metadata and token info       |
| [`gist_conversations_list_conversation_messages`](#gist_conversations_list_conversation_messages)             | List messages in a conversation                  |
| [`gist_conversations_list_conversations`](#gist_conversations_list_conversations)                             | List all conversations                           |
| [`gist_conversations_list_teammates`](#gist_conversations_list_teammates)                                     | List all teammates                               |
| [`gist_conversations_list_teams`](#gist_conversations_list_teams)                                             | List all teams                                   |
| [`gist_conversations_prioritize_conversation`](#gist_conversations_prioritize_conversation)                   | Set conversation priority                        |
| [`gist_conversations_reply_to_conversation`](#gist_conversations_reply_to_conversation)                       | Reply to a conversation or add a note            |
| [`gist_conversations_search_conversations`](#gist_conversations_search_conversations)                         | Search conversations with filters                |
| [`gist_conversations_tag_conversation`](#gist_conversations_tag_conversation)                                 | Tag a conversation                               |
| [`gist_conversations_untag_conversation`](#gist_conversations_untag_conversation)                             | Remove a tag from a conversation                 |
| [`gist_conversations_update_conversation`](#gist_conversations_update_conversation)                           | Update a conversation (title, properties, state) |

***

## gist\_conversations\_assign\_conversation

Assign or unassign a conversation

**Parameters:**

| Parameter         | Type    | Required | Default | Description                                          |                                                                 |
| ----------------- | ------- | -------- | ------- | ---------------------------------------------------- | --------------------------------------------------------------- |
| `conversation_id` | integer | Yes      | —       | Conversation ID                                      |                                                                 |
| `assignee_id`     | integer | null     | No      | —                                                    | ID of the assignee (teammate or team). Set to null to unassign. |
| `assignee_type`   | string  | No       | —       | Type of assignee (required when assigning to a team) |                                                                 |
| `teammate_id`     | integer | Yes      | —       | ID of the teammate performing the assignment         |                                                                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "conversation_id": {
        "type": "integer",
        "description": "Conversation ID"
      },
      "assignee_id": {
        "type": [
          "integer",
          "null"
        ],
        "description": "ID of the assignee (teammate or team). Set to null to unassign."
      },
      "assignee_type": {
        "type": "string",
        "description": "Type of assignee (required when assigning to a team)",
        "enum": [
          "teammate",
          "team"
        ]
      },
      "teammate_id": {
        "type": "integer",
        "description": "ID of the teammate performing the assignment"
      }
    },
    "required": [
      "PCID",
      "conversation_id",
      "teammate_id"
    ]
  }
  ```
</Expandable>

***

## gist\_conversations\_create\_conversation

Create a new conversation

**Parameters:**

| Parameter           | Type   | Required | Default | Description                             |
| ------------------- | ------ | -------- | ------- | --------------------------------------- |
| `body`              | string | Yes      | —       | Message body (plain text)               |
| `custom_properties` | object | No       | —       | Custom properties                       |
| `from`              | object | Yes      | —       | Sender info with id, user\_id, or email |
| `title`             | string | No       | —       | Conversation title                      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "body": {
        "type": "string",
        "description": "Message body (plain text)"
      },
      "custom_properties": {
        "type": "object",
        "description": "Custom properties"
      },
      "from": {
        "type": "object",
        "description": "Sender info with id, user_id, or email",
        "properties": {
          "id": {
            "type": "string",
            "description": "The id value"
          },
          "user_id": {
            "type": "string",
            "description": "User Id"
          },
          "email": {
            "type": "string",
            "description": "The email value"
          }
        }
      },
      "title": {
        "type": "string",
        "description": "Conversation title"
      }
    },
    "required": [
      "PCID",
      "body",
      "from"
    ]
  }
  ```
</Expandable>

***

## gist\_conversations\_delete\_conversation

Delete a conversation

**Parameters:**

| Parameter         | Type    | Required | Default | Description     |
| ----------------- | ------- | -------- | ------- | --------------- |
| `conversation_id` | integer | Yes      | —       | Conversation ID |

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

***

## gist\_conversations\_get\_conversation

Retrieve a conversation

**Parameters:**

| Parameter         | Type    | Required | Default | Description     |
| ----------------- | ------- | -------- | ------- | --------------- |
| `conversation_id` | integer | Yes      | —       | Conversation ID |

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

***

## gist\_conversations\_get\_conversation\_counts

Get global conversation counts

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

***

## gist\_conversations\_get\_team

Retrieve a team

**Parameters:**

| Parameter | Type   | Required | Default | Description |
| --------- | ------ | -------- | ------- | ----------- |
| `team_id` | string | Yes      | —       | Team ID     |

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

***

## gist\_conversations\_get\_team\_conversation\_counts

Get conversation counts by team

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

***

## gist\_conversations\_get\_teammate

Retrieve a teammate

**Parameters:**

| Parameter     | Type   | Required | Default | Description                   |
| ------------- | ------ | -------- | ------- | ----------------------------- |
| `teammate_id` | string | Yes      | —       | Teammate ID                   |
| `email`       | string | No       | —       | Alternative: look up by email |

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

***

## gist\_conversations\_get\_teammate\_conversation\_counts

Get conversation counts by teammate

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

***

## gist\_conversations\_get\_workspace\_meta

Retrieve workspace metadata and token info

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

***

## gist\_conversations\_list\_conversation\_messages

List messages in a conversation

**Parameters:**

| Parameter         | Type    | Required | Default | Description               |
| ----------------- | ------- | -------- | ------- | ------------------------- |
| `conversation_id` | integer | Yes      | —       | Conversation ID           |
| `page`            | integer | No       | —       | Page number               |
| `per_page`        | integer | No       | —       | Results per page (max 60) |
| `with_notes`      | boolean | No       | —       | Include internal notes    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "conversation_id": {
        "type": "integer",
        "description": "Conversation ID"
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      },
      "per_page": {
        "type": "integer",
        "description": "Results per page (max 60)"
      },
      "with_notes": {
        "type": "boolean",
        "description": "Include internal notes"
      }
    },
    "required": [
      "PCID",
      "conversation_id"
    ]
  }
  ```
</Expandable>

***

## gist\_conversations\_list\_conversations

List all conversations

**Parameters:**

| Parameter  | Type    | Required | Default | Description      |
| ---------- | ------- | -------- | ------- | ---------------- |
| `order`    | string  | No       | —       | Sort order       |
| `order_by` | string  | No       | —       | Sort field       |
| `status`   | string  | No       | —       | Filter by status |
| `page`     | integer | No       | —       | Page number      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "order": {
        "type": "string",
        "description": "Sort order",
        "enum": [
          "asc",
          "desc"
        ]
      },
      "order_by": {
        "type": "string",
        "description": "Sort field",
        "enum": [
          "created_at",
          "updated_at",
          "waiting_longest"
        ]
      },
      "status": {
        "type": "string",
        "description": "Filter by status",
        "enum": [
          "all",
          "open",
          "closed",
          "snoozed"
        ]
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## gist\_conversations\_list\_teammates

List all teammates

**Parameters:**

| Parameter  | Type    | Required | Default | Description      |
| ---------- | ------- | -------- | ------- | ---------------- |
| `page`     | integer | No       | —       | Page number      |
| `per_page` | integer | No       | —       | Results per page |

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

***

## gist\_conversations\_list\_teams

List all teams

**Parameters:**

| Parameter  | Type    | Required | Default | Description      |
| ---------- | ------- | -------- | ------- | ---------------- |
| `page`     | integer | No       | —       | Page number      |
| `per_page` | integer | No       | —       | Results per page |

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

***

## gist\_conversations\_prioritize\_conversation

Set conversation priority

**Parameters:**

| Parameter         | Type    | Required | Default | Description                        |
| ----------------- | ------- | -------- | ------- | ---------------------------------- |
| `conversation_id` | integer | Yes      | —       | Conversation ID                    |
| `priority`        | string  | Yes      | —       | Priority level                     |
| `teammate_id`     | integer | No       | —       | Teammate ID performing the action  |
| `type`            | string  | No       | —       | Set to 'bot' if performed by a bot |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "conversation_id": {
        "type": "integer",
        "description": "Conversation ID"
      },
      "priority": {
        "type": "string",
        "description": "Priority level",
        "enum": [
          "priority",
          "not_priority"
        ]
      },
      "teammate_id": {
        "type": "integer",
        "description": "Teammate ID performing the action"
      },
      "type": {
        "type": "string",
        "description": "Set to 'bot' if performed by a bot",
        "enum": [
          "bot"
        ]
      }
    },
    "required": [
      "PCID",
      "conversation_id",
      "priority"
    ]
  }
  ```
</Expandable>

***

## gist\_conversations\_reply\_to\_conversation

Reply to a conversation or add a note

**Parameters:**

| Parameter         | Type    | Required | Default | Description                                                                |
| ----------------- | ------- | -------- | ------- | -------------------------------------------------------------------------- |
| `conversation_id` | integer | Yes      | —       | Conversation ID                                                            |
| `body`            | string  | Yes      | —       | Message body                                                               |
| `from`            | object  | No       | —       | Sender info                                                                |
| `message_type`    | string  | Yes      | —       | Message type: 'reply' for customer-visible reply, 'note' for internal note |
| `teammate_id`     | integer | No       | —       | Teammate ID (required when from.type=teammate)                             |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "conversation_id": {
        "type": "integer",
        "description": "Conversation ID"
      },
      "body": {
        "type": "string",
        "description": "Message body"
      },
      "from": {
        "type": "object",
        "description": "Sender info",
        "properties": {
          "type": {
            "type": "string",
            "description": "Sender type",
            "enum": [
              "contact",
              "teammate",
              "bot"
            ]
          },
          "id": {
            "type": "string",
            "description": "Contact ID (when type=contact)"
          },
          "user_id": {
            "type": "string",
            "description": "User ID (when type=contact)"
          },
          "email": {
            "type": "string",
            "description": "Email (when type=contact)"
          }
        }
      },
      "message_type": {
        "type": "string",
        "description": "Message type: 'reply' for customer-visible reply, 'note' for internal note",
        "enum": [
          "reply",
          "note"
        ]
      },
      "teammate_id": {
        "type": "integer",
        "description": "Teammate ID (required when from.type=teammate)"
      }
    },
    "required": [
      "PCID",
      "conversation_id",
      "body",
      "message_type"
    ]
  }
  ```
</Expandable>

***

## gist\_conversations\_search\_conversations

Search conversations with filters

**Parameters:**

| Parameter      | Type      | Required | Default | Description                                                                 |
| -------------- | --------- | -------- | ------- | --------------------------------------------------------------------------- |
| `order`        | string    | No       | —       | Sort order                                                                  |
| `order_by`     | string    | No       | —       | Sort field                                                                  |
| `status`       | string    | No       | —       | Filter by status                                                            |
| `page`         | integer   | No       | —       | Page number                                                                 |
| `filter_query` | object\[] | Yes      | —       | Filter criteria groups (groups are ANDed, criteria within a group are ORed) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "order": {
        "type": "string",
        "description": "Sort order",
        "enum": [
          "asc",
          "desc"
        ]
      },
      "order_by": {
        "type": "string",
        "description": "Sort field"
      },
      "status": {
        "type": "string",
        "description": "Filter by status",
        "enum": [
          "all",
          "open",
          "closed",
          "snoozed"
        ]
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      },
      "filter_query": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "criteria": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "key": {
                    "type": "string",
                    "description": "Filter key (teammate_assigned_id, team_assigned_id, is_assigned, channel, conversation_tags, contact.id)"
                  },
                  "operator": {
                    "type": "string",
                    "description": "Comparison operator"
                  },
                  "value": {
                    "description": "Filter value"
                  }
                }
              },
              "description": "The criteria value"
            }
          }
        },
        "description": "Filter criteria groups (groups are ANDed, criteria within a group are ORed)"
      }
    },
    "required": [
      "PCID",
      "filter_query"
    ]
  }
  ```
</Expandable>

***

## gist\_conversations\_tag\_conversation

Tag a conversation

**Parameters:**

| Parameter         | Type    | Required | Default | Description                                  |
| ----------------- | ------- | -------- | ------- | -------------------------------------------- |
| `conversation_id` | integer | Yes      | —       | Conversation ID                              |
| `message_id`      | integer | No       | —       | Message ID to tag (defaults to last message) |
| `tags`            | string  | Yes      | —       | Comma-separated tag names                    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "conversation_id": {
        "type": "integer",
        "description": "Conversation ID"
      },
      "message_id": {
        "type": "integer",
        "description": "Message ID to tag (defaults to last message)"
      },
      "tags": {
        "type": "string",
        "description": "Comma-separated tag names"
      }
    },
    "required": [
      "PCID",
      "conversation_id",
      "tags"
    ]
  }
  ```
</Expandable>

***

## gist\_conversations\_untag\_conversation

Remove a tag from a conversation

**Parameters:**

| Parameter         | Type    | Required | Default | Description                           |
| ----------------- | ------- | -------- | ------- | ------------------------------------- |
| `conversation_id` | integer | Yes      | —       | Conversation ID                       |
| `message_id`      | integer | No       | —       | Message ID (defaults to last message) |
| `tag_id`          | integer | Yes      | —       | Tag ID to remove                      |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "conversation_id": {
        "type": "integer",
        "description": "Conversation ID"
      },
      "message_id": {
        "type": "integer",
        "description": "Message ID (defaults to last message)"
      },
      "tag_id": {
        "type": "integer",
        "description": "Tag ID to remove"
      }
    },
    "required": [
      "PCID",
      "conversation_id",
      "tag_id"
    ]
  }
  ```
</Expandable>

***

## gist\_conversations\_update\_conversation

Update a conversation (title, properties, state)

**Parameters:**

| Parameter           | Type    | Required | Default | Description                                                                |
| ------------------- | ------- | -------- | ------- | -------------------------------------------------------------------------- |
| `conversation_id`   | integer | Yes      | —       | Conversation ID                                                            |
| `custom_properties` | object  | No       | —       | Custom properties                                                          |
| `snoozed_until`     | integer | No       | —       | Unix timestamp for when to unsnooze (required when state='snoozed')        |
| `state`             | string  | No       | —       | Set to 'closed' to close, 'snoozed' to snooze, 'open' to reopen/unsnooze   |
| `teammate_id`       | integer | No       | —       | ID of the teammate performing the action                                   |
| `title`             | string  | No       | —       | Conversation title                                                         |
| `type`              | string  | No       | —       | Set to 'bot' if action is performed by a bot (alternative to teammate\_id) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "conversation_id": {
        "type": "integer",
        "description": "Conversation ID"
      },
      "custom_properties": {
        "type": "object",
        "description": "Custom properties"
      },
      "snoozed_until": {
        "type": "integer",
        "description": "Unix timestamp for when to unsnooze (required when state='snoozed')"
      },
      "state": {
        "type": "string",
        "description": "Set to 'closed' to close, 'snoozed' to snooze, 'open' to reopen/unsnooze",
        "enum": [
          "open",
          "closed",
          "snoozed"
        ]
      },
      "teammate_id": {
        "type": "integer",
        "description": "ID of the teammate performing the action"
      },
      "title": {
        "type": "string",
        "description": "Conversation title"
      },
      "type": {
        "type": "string",
        "description": "Set to 'bot' if action is performed by a bot (alternative to teammate_id)",
        "enum": [
          "bot"
        ]
      }
    },
    "required": [
      "PCID",
      "conversation_id"
    ]
  }
  ```
</Expandable>