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	Assign or unassign a conversation
gist_conversations_create_conversation	Create a new conversation
gist_conversations_delete_conversation	Delete a conversation
gist_conversations_get_conversation	Retrieve a conversation
gist_conversations_get_conversation_counts	Get global conversation counts
gist_conversations_get_team	Retrieve a team
gist_conversations_get_team_conversation_counts	Get conversation counts by team
gist_conversations_get_teammate	Retrieve a teammate
gist_conversations_get_teammate_conversation_counts	Get conversation counts by teammate
gist_conversations_get_workspace_meta	Retrieve workspace metadata and token info
gist_conversations_list_conversation_messages	List messages in a conversation
gist_conversations_list_conversations	List all conversations
gist_conversations_list_teammates	List all teammates
gist_conversations_list_teams	List all teams
gist_conversations_prioritize_conversation	Set conversation priority
gist_conversations_reply_to_conversation	Reply to a conversation or add a note
gist_conversations_search_conversations	Search conversations with filters
gist_conversations_tag_conversation	Tag a conversation
gist_conversations_untag_conversation	Remove a tag from a 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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

gist_conversations_delete_conversation

Delete a conversation

Parameters:

Parameter	Type	Required	Default	Description
conversation_id	integer	Yes	—	Conversation ID

Show inputSchema

{
  "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"
  ]
}

---

gist_conversations_get_conversation

Retrieve a conversation

Parameters:

Parameter	Type	Required	Default	Description
conversation_id	integer	Yes	—	Conversation ID

Show inputSchema

{
  "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"
  ]
}

---

gist_conversations_get_conversation_counts

Get global conversation counts

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    }
  },
  "required": [
    "PCID"
  ]
}

---

gist_conversations_get_team

Retrieve a team

Parameters:

Parameter	Type	Required	Default	Description
team_id	string	Yes	—	Team ID

Show inputSchema

{
  "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"
  ]
}

---

gist_conversations_get_team_conversation_counts

Get conversation counts by team

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    }
  },
  "required": [
    "PCID"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

gist_conversations_get_teammate_conversation_counts

Get conversation counts by teammate

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    }
  },
  "required": [
    "PCID"
  ]
}

---

gist_conversations_get_workspace_meta

Retrieve workspace metadata and token info

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID for the authenticated connection"
    }
  },
  "required": [
    "PCID"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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)

Show inputSchema

{
  "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"
  ]
}

---

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)

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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

Show inputSchema

{
  "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"
  ]
}

---

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)

Show inputSchema

{
  "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"
  ]
}