gist-conversations - Pinkfish - AI Agents & Workflows for Getting Work Done

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

​Tools

​gist_conversations_assign_conversation

​gist_conversations_create_conversation

​gist_conversations_delete_conversation

​gist_conversations_get_conversation

​gist_conversations_get_conversation_counts

​gist_conversations_get_team

​gist_conversations_get_team_conversation_counts

​gist_conversations_get_teammate

​gist_conversations_get_teammate_conversation_counts

​gist_conversations_get_workspace_meta

​gist_conversations_list_conversation_messages

​gist_conversations_list_conversations

​gist_conversations_list_teammates

​gist_conversations_list_teams

​gist_conversations_prioritize_conversation

​gist_conversations_reply_to_conversation

​gist_conversations_search_conversations

​gist_conversations_tag_conversation

​gist_conversations_untag_conversation

​gist_conversations_update_conversation

Tools

gist_conversations_assign_conversation

gist_conversations_create_conversation

gist_conversations_delete_conversation

gist_conversations_get_conversation

gist_conversations_get_conversation_counts

gist_conversations_get_team

gist_conversations_get_team_conversation_counts

gist_conversations_get_teammate

gist_conversations_get_teammate_conversation_counts

gist_conversations_get_workspace_meta

gist_conversations_list_conversation_messages

gist_conversations_list_conversations

gist_conversations_list_teammates

gist_conversations_list_teams

gist_conversations_prioritize_conversation

gist_conversations_reply_to_conversation

gist_conversations_search_conversations

gist_conversations_tag_conversation

gist_conversations_untag_conversation

gist_conversations_update_conversation