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

# habitica-social

> Habitica Social - groups, guilds, party, challenges, and chat

**Server path:** `/habitica-social` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                                                                                                            | Description                      |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| [`habitica_social_create_challenges`](#habitica_social_create_challenges)                                                                                       | Create a challenge               |
| [`habitica_social_create_challenges_by_challenge_id_clone`](#habitica_social_create_challenges_by_challenge_id_clone)                                           | Clone a challenge                |
| [`habitica_social_create_challenges_by_challenge_id_join`](#habitica_social_create_challenges_by_challenge_id_join)                                             | Join a challenge                 |
| [`habitica_social_create_challenges_by_challenge_id_leave`](#habitica_social_create_challenges_by_challenge_id_leave)                                           | Leave Challenge                  |
| [`habitica_social_create_challenges_by_challenge_id_select_winner_by_winner_id`](#habitica_social_create_challenges_by_challenge_id_select_winner_by_winner_id) | Select Challenge Winner          |
| [`habitica_social_create_groups`](#habitica_social_create_groups)                                                                                               | Create a Group                   |
| [`habitica_social_create_groups_by_group_id_add_manager`](#habitica_social_create_groups_by_group_id_add_manager)                                               | Add Group Manager                |
| [`habitica_social_create_groups_by_group_id_chat`](#habitica_social_create_groups_by_group_id_chat)                                                             | Send a chat message in a group   |
| [`habitica_social_create_groups_by_group_id_chat_by_chat_id_clearflags`](#habitica_social_create_groups_by_group_id_chat_by_chat_id_clearflags)                 | Clear flags                      |
| [`habitica_social_create_groups_by_group_id_chat_by_chat_id_flag`](#habitica_social_create_groups_by_group_id_chat_by_chat_id_flag)                             | Flag a group chat message        |
| [`habitica_social_create_groups_by_group_id_chat_by_chat_id_like`](#habitica_social_create_groups_by_group_id_chat_by_chat_id_like)                             | Like Group Chat Message          |
| [`habitica_social_create_groups_by_group_id_chat_seen`](#habitica_social_create_groups_by_group_id_chat_seen)                                                   | Mark Group Chat Messages as Seen |
| [`habitica_social_create_groups_by_group_id_invite`](#habitica_social_create_groups_by_group_id_invite)                                                         | Invite users to a group          |
| [`habitica_social_create_groups_by_group_id_join`](#habitica_social_create_groups_by_group_id_join)                                                             | Join a group                     |
| [`habitica_social_create_groups_by_group_id_leave`](#habitica_social_create_groups_by_group_id_leave)                                                           | Leave a group                    |
| [`habitica_social_create_groups_by_group_id_quests_abort`](#habitica_social_create_groups_by_group_id_quests_abort)                                             | Abort Group Quest                |
| [`habitica_social_create_groups_by_group_id_quests_accept`](#habitica_social_create_groups_by_group_id_quests_accept)                                           | Accept Group Quest               |
| [`habitica_social_create_groups_by_group_id_quests_cancel`](#habitica_social_create_groups_by_group_id_quests_cancel)                                           | Cancel Group Quest               |
| [`habitica_social_create_groups_by_group_id_quests_force_start`](#habitica_social_create_groups_by_group_id_quests_force_start)                                 | Force-Start Group Quest          |
| [`habitica_social_create_groups_by_group_id_quests_invite_by_quest_key`](#habitica_social_create_groups_by_group_id_quests_invite_by_quest_key)                 | Invite users to a quest          |
| [`habitica_social_create_groups_by_group_id_quests_leave`](#habitica_social_create_groups_by_group_id_quests_leave)                                             | Leave Group Quest                |
| [`habitica_social_create_groups_by_group_id_quests_reject`](#habitica_social_create_groups_by_group_id_quests_reject)                                           | Reject Group Quest               |
| [`habitica_social_create_groups_by_group_id_reject_invite`](#habitica_social_create_groups_by_group_id_reject_invite)                                           | Reject a group invitation        |
| [`habitica_social_create_groups_by_group_id_remove_manager`](#habitica_social_create_groups_by_group_id_remove_manager)                                         | Remove a manager from a group    |
| [`habitica_social_create_groups_by_group_id_remove_member_by_member_id`](#habitica_social_create_groups_by_group_id_remove_member_by_member_id)                 | Remove a member from a group     |
| [`habitica_social_create_groups_create_plan`](#habitica_social_create_groups_create_plan)                                                                       | Create Group Plan                |
| [`habitica_social_create_groups_party_chat`](#habitica_social_create_groups_party_chat)                                                                         | Send a chat message to the party |
| [`habitica_social_create_members_send_private_message`](#habitica_social_create_members_send_private_message)                                                   | Send Private Message             |
| [`habitica_social_create_members_transfer_gems`](#habitica_social_create_members_transfer_gems)                                                                 | Transfer Gems                    |
| [`habitica_social_delete_challenges_by_challenge_id`](#habitica_social_delete_challenges_by_challenge_id)                                                       | Delete a challenge               |
| [`habitica_social_delete_groups_by_group_id_chat_by_chat_id`](#habitica_social_delete_groups_by_group_id_chat_by_chat_id)                                       | Delete chat message from a group |
| [`habitica_social_get_challenges_by_challenge_id`](#habitica_social_get_challenges_by_challenge_id)                                                             | Get challenges for a group       |
| [`habitica_social_get_challenges_by_challenge_id_export_csv`](#habitica_social_get_challenges_by_challenge_id_export_csv)                                       | Export Challenge to CSV          |
| [`habitica_social_get_challenges_by_challenge_id_members`](#habitica_social_get_challenges_by_challenge_id_members)                                             | Get members for a challenge      |
| [`habitica_social_get_challenges_by_challenge_id_members_by_member_id`](#habitica_social_get_challenges_by_challenge_id_members_by_member_id)                   | Get a challenge member progress  |
| [`habitica_social_get_challenges_groups_by_group_id`](#habitica_social_get_challenges_groups_by_group_id)                                                       | Get challenges for a group       |
| [`habitica_social_get_challenges_user`](#habitica_social_get_challenges_user)                                                                                   | Get challenges for a user        |
| [`habitica_social_get_group_plans`](#habitica_social_get_group_plans)                                                                                           | Get Group Plans                  |
| [`habitica_social_get_groups`](#habitica_social_get_groups)                                                                                                     | Get user's groups                |
| [`habitica_social_get_groups_by_group_id`](#habitica_social_get_groups_by_group_id)                                                                             | Get group information            |
| [`habitica_social_get_groups_by_group_id_chat`](#habitica_social_get_groups_by_group_id_chat)                                                                   | Get group chat messages          |
| [`habitica_social_get_groups_by_group_id_invites`](#habitica_social_get_groups_by_group_id_invites)                                                             | Get invites for a group          |
| [`habitica_social_get_groups_by_group_id_members`](#habitica_social_get_groups_by_group_id_members)                                                             | Get members for a group          |
| [`habitica_social_get_groups_party_chat`](#habitica_social_get_groups_party_chat)                                                                               | Get party chat messages          |
| [`habitica_social_get_looking_for_party`](#habitica_social_get_looking_for_party)                                                                               | Get users in search of parties   |
| [`habitica_social_get_members_by_member_id`](#habitica_social_get_members_by_member_id)                                                                         | Get habitica member by ID        |
| [`habitica_social_get_members_by_member_id_achievements`](#habitica_social_get_members_by_member_id_achievements)                                               | Get member achievements object   |
| [`habitica_social_get_members_by_to_user_id_objections_by_interaction`](#habitica_social_get_members_by_to_user_id_objections_by_interaction)                   | Get objections to interaction    |
| [`habitica_social_update_challenges_by_challenge_id`](#habitica_social_update_challenges_by_challenge_id)                                                       | Update a challenge               |
| [`habitica_social_update_groups_by_group_id`](#habitica_social_update_groups_by_group_id)                                                                       | Update Group                     |

***

## habitica\_social\_create\_challenges

Create a challenge

**Parameters:**

| Parameter     | Type    | Required | Default | Description                                                                                                                          |
| ------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| `description` | string  | No       | —       | A detailed description of the challenge.                                                                                             |
| `group`       | string  | Yes      | —       | The UUID of the group to which the challenge belongs.                                                                                |
| `name`        | string  | Yes      | —       | The full name of the challenge.                                                                                                      |
| `official`    | boolean | No       | —       | Specifies whether the challenge is an official Habitica challenge.                                                                   |
| `prize`       | number  | No       | —       | The prize or reward associated with the challenge.                                                                                   |
| `shortName`   | string  | Yes      | —       | A shortened name for the challenge, to be used as a tag.                                                                             |
| `summary`     | string  | No       | —       | A short summary advertising the main purpose of the challenge; maximum 250 characters; if not supplied, challenge.name will be used. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "description": {
        "type": "string",
        "description": "A detailed description of the challenge."
      },
      "group": {
        "type": "string",
        "description": "The UUID of the group to which the challenge belongs."
      },
      "name": {
        "type": "string",
        "description": "The full name of the challenge."
      },
      "official": {
        "type": "boolean",
        "description": "Specifies whether the challenge is an official Habitica challenge."
      },
      "prize": {
        "type": "number",
        "description": "The prize or reward associated with the challenge."
      },
      "shortName": {
        "type": "string",
        "description": "A shortened name for the challenge, to be used as a tag."
      },
      "summary": {
        "type": "string",
        "description": "A short summary advertising the main purpose of the challenge; maximum 250 characters; if not supplied, challenge.name will be used."
      }
    },
    "required": [
      "PCID",
      "group",
      "name",
      "shortName"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_challenges\_by\_challenge\_id\_clone

Clone a challenge

**Parameters:**

| Parameter     | Type   | Required | Default | Description                  |
| ------------- | ------ | -------- | ------- | ---------------------------- |
| `challengeId` | string | Yes      | —       | ID of the challenge to clone |

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

***

## habitica\_social\_create\_challenges\_by\_challenge\_id\_join

Join a challenge

**Parameters:**

| Parameter     | Type   | Required | Default | Description         |
| ------------- | ------ | -------- | ------- | ------------------- |
| `challengeId` | string | Yes      | —       | ID of the challenge |

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

***

## habitica\_social\_create\_challenges\_by\_challenge\_id\_leave

Leave Challenge

**Parameters:**

| Parameter     | Type   | Required | Default | Description                                                                     |
| ------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------- |
| `challengeId` | string | Yes      | —       | ID of the challenge to leave                                                    |
| `keep`        | string | No       | —       | Specify whether to remove all or keep all challenge-related tasks upon leaving. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "challengeId": {
        "type": "string",
        "description": "ID of the challenge to leave"
      },
      "keep": {
        "type": "string",
        "description": "Specify whether to remove all or keep all challenge-related tasks upon leaving.",
        "enum": [
          "remove-all",
          "keep-all"
        ]
      }
    },
    "required": [
      "PCID",
      "challengeId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_challenges\_by\_challenge\_id\_select\_winner\_by\_winner\_id

Select Challenge Winner

**Parameters:**

| Parameter     | Type   | Required | Default | Description                                                |
| ------------- | ------ | -------- | ------- | ---------------------------------------------------------- |
| `challengeId` | string | Yes      | —       | The Challenge ID for the challenge to close with a winner. |
| `winnerId`    | string | Yes      | —       | The User ID of the winning user.                           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "challengeId": {
        "type": "string",
        "description": "The Challenge ID for the challenge to close with a winner."
      },
      "winnerId": {
        "type": "string",
        "description": "The User ID of the winning user."
      }
    },
    "required": [
      "PCID",
      "challengeId",
      "winnerId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups

Create a Group

**Parameters:**

| Parameter | Type   | Required | Default | Description                              |
| --------- | ------ | -------- | ------- | ---------------------------------------- |
| `name`    | string | Yes      | —       | The name of the new group.               |
| `privacy` | string | Yes      | —       | Privacy of group (party MUST be private) |
| `type`    | string | Yes      | —       | Type of group (guild or party)           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "name": {
        "type": "string",
        "description": "The name of the new group."
      },
      "privacy": {
        "type": "string",
        "description": "Privacy of group (party MUST be private)",
        "enum": [
          "private",
          "public"
        ]
      },
      "type": {
        "type": "string",
        "description": "Type of group (guild or party)",
        "enum": [
          "guild",
          "party"
        ]
      }
    },
    "required": [
      "PCID",
      "name",
      "privacy",
      "type"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_add\_manager

Add Group Manager

**Parameters:**

| Parameter   | Type   | Required | Default | Description                                                                        |
| ----------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------- |
| `groupId`   | string | Yes      | —       | The group \_id ('party' for the user party and 'habitrpg' for tavern are accepted) |
| `managerId` | string | Yes      | —       | The UUID of the user.                                                              |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      },
      "managerId": {
        "type": "string",
        "description": "The UUID of the user."
      }
    },
    "required": [
      "PCID",
      "groupId",
      "managerId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_chat

Send a chat message in a group

**Parameters:**

| Parameter     | Type   | Required | Default | Description                                                                        |
| ------------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------- |
| `groupId`     | string | Yes      | —       | The group id ('party' for the user party and 'habitrpg' for tavern are accepted)   |
| `previousMsg` | string | No       | —       | The previous chat message's UUID which will force a return of the full group chat. |
| `message`     | string | No       | —       | The content of the chat message.                                                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      },
      "previousMsg": {
        "type": "string",
        "description": "The previous chat message's UUID which will force a return of the full group chat."
      },
      "message": {
        "type": "string",
        "description": "The content of the chat message."
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_chat\_by\_chat\_id\_clearflags

Clear flags

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                      |
| --------- | ------ | -------- | ------- | -------------------------------------------------------------------------------- |
| `groupId` | string | Yes      | —       | The group id ('party' for the user party and 'habitrpg' for tavern are accepted) |
| `chatId`  | string | Yes      | —       | The UUID of the chat message to clear flags from.                                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      },
      "chatId": {
        "type": "string",
        "description": "The UUID of the chat message to clear flags from."
      }
    },
    "required": [
      "PCID",
      "groupId",
      "chatId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_chat\_by\_chat\_id\_flag

Flag a group chat message

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                       |
| --------- | ------ | -------- | ------- | --------------------------------------------------------------------------------- |
| `groupId` | string | Yes      | —       | The group id ('party' for the user party and 'habitrpg' for tavern are accepted). |
| `chatId`  | string | Yes      | —       | The chat message id.                                                              |
| `comment` | string | No       | —       | Explanation why the message was flagged.                                          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)."
      },
      "chatId": {
        "type": "string",
        "description": "The chat message id."
      },
      "comment": {
        "type": "string",
        "description": "Explanation why the message was flagged."
      }
    },
    "required": [
      "PCID",
      "groupId",
      "chatId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_chat\_by\_chat\_id\_like

Like Group Chat Message

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                      |
| --------- | ------ | -------- | ------- | -------------------------------------------------------------------------------- |
| `groupId` | string | Yes      | —       | The group id ('party' for the user party and 'habitrpg' for tavern are accepted) |
| `chatId`  | string | Yes      | —       | The UUID of the chat message to like.                                            |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      },
      "chatId": {
        "type": "string",
        "description": "The UUID of the chat message to like."
      }
    },
    "required": [
      "PCID",
      "groupId",
      "chatId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_chat\_seen

Mark Group Chat Messages as Seen

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                      |
| --------- | ------ | -------- | ------- | -------------------------------------------------------------------------------- |
| `groupId` | string | Yes      | —       | The group id ('party' for the user party and 'habitrpg' for tavern are accepted) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_invite

Invite users to a group

**Parameters:**

| Parameter | Type      | Required | Default | Description                                                                        |
| --------- | --------- | -------- | ------- | ---------------------------------------------------------------------------------- |
| `groupId` | string    | Yes      | —       | The group \_id ('party' for the user party and 'habitrpg' for tavern are accepted) |
| `emails`  | object\[] | No       | —       | An array of objects, each representing one email address to invite.                |
| `uuids`   | string\[] | No       | —       | An array of user IDs to invite.                                                    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      },
      "emails": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "email": {
              "type": "string",
              "format": "email",
              "description": "The email address of the user being invited."
            },
            "name": {
              "type": "string",
              "description": "The name of the user being invited."
            }
          },
          "required": [
            "email"
          ]
        },
        "description": "An array of objects, each representing one email address to invite."
      },
      "uuids": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uuid"
        },
        "description": "An array of user IDs to invite."
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_join

Join a group

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                        |
| --------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------- |
| `groupId` | string | Yes      | —       | The group \_id ('party' for the user party and 'habitrpg' for tavern are accepted) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_leave

Leave a group

**Parameters:**

| Parameter        | Type   | Required | Default | Description                                                                         |
| ---------------- | ------ | -------- | ------- | ----------------------------------------------------------------------------------- |
| `groupId`        | string | Yes      | —       | The group \_id ('party' for the user party and 'habitrpg' for tavern are accepted)  |
| `keep`           | string | No       | —       | Specify whether to remove or keep challenges when leaving the group.                |
| `keepChallenges` | string | No       | —       | Specify whether to remain in challenges or leave challenges upon leaving the group. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      },
      "keep": {
        "type": "string",
        "description": "Specify whether to remove or keep challenges when leaving the group.",
        "enum": [
          "remove-all",
          "keep-all"
        ]
      },
      "keepChallenges": {
        "type": "string",
        "description": "Specify whether to remain in challenges or leave challenges upon leaving the group.",
        "enum": [
          "remain-in-challenges",
          "leave-challenges"
        ]
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_quests\_abort

Abort Group Quest

**Parameters:**

| Parameter | Type   | Required | Default | Description                 |
| --------- | ------ | -------- | ------- | --------------------------- |
| `groupId` | string | Yes      | —       | The group \_id (or 'party') |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id (or 'party')"
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_quests\_accept

Accept Group Quest

**Parameters:**

| Parameter | Type   | Required | Default | Description                 |
| --------- | ------ | -------- | ------- | --------------------------- |
| `groupId` | string | Yes      | —       | The group \_id (or 'party') |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id (or 'party')"
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_quests\_cancel

Cancel Group Quest

**Parameters:**

| Parameter | Type   | Required | Default | Description                 |
| --------- | ------ | -------- | ------- | --------------------------- |
| `groupId` | string | Yes      | —       | The group \_id (or 'party') |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id (or 'party')"
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_quests\_force\_start

Force-Start Group Quest

**Parameters:**

| Parameter | Type   | Required | Default | Description                 |
| --------- | ------ | -------- | ------- | --------------------------- |
| `groupId` | string | Yes      | —       | The group \_id (or 'party') |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id (or 'party')"
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_quests\_invite\_by\_quest\_key

Invite users to a quest

**Parameters:**

| Parameter  | Type   | Required | Default | Description                  |
| ---------- | ------ | -------- | ------- | ---------------------------- |
| `groupId`  | string | Yes      | —       | The group \_id (or 'party')  |
| `questKey` | string | Yes      | —       | The unique key of the quest. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id (or 'party')"
      },
      "questKey": {
        "type": "string",
        "description": "The unique key of the quest."
      }
    },
    "required": [
      "PCID",
      "groupId",
      "questKey"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_quests\_leave

Leave Group Quest

**Parameters:**

| Parameter | Type   | Required | Default | Description                 |
| --------- | ------ | -------- | ------- | --------------------------- |
| `groupId` | string | Yes      | —       | The group \_id (or 'party') |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id (or 'party')"
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_quests\_reject

Reject Group Quest

**Parameters:**

| Parameter | Type   | Required | Default | Description                 |
| --------- | ------ | -------- | ------- | --------------------------- |
| `groupId` | string | Yes      | —       | The group \_id (or 'party') |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id (or 'party')"
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_reject\_invite

Reject a group invitation

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                        |
| --------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------- |
| `groupId` | string | Yes      | —       | The group \_id ('party' for the user party and 'habitrpg' for tavern are accepted) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_remove\_manager

Remove a manager from a group

**Parameters:**

| Parameter   | Type   | Required | Default | Description                                                                        |
| ----------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------- |
| `groupId`   | string | Yes      | —       | The group \_id ('party' for the user party and 'habitrpg' for tavern are accepted) |
| `managerId` | string | Yes      | —       | The UUID of the user.                                                              |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      },
      "managerId": {
        "type": "string",
        "description": "The UUID of the user."
      }
    },
    "required": [
      "PCID",
      "groupId",
      "managerId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_by\_group\_id\_remove\_member\_by\_member\_id

Remove a member from a group

**Parameters:**

| Parameter  | Type   | Required | Default | Description                                                                        |
| ---------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------- |
| `groupId`  | string | Yes      | —       | The group \_id ('party' for the user party and 'habitrpg' for tavern are accepted) |
| `memberId` | string | Yes      | —       | The ID of the member to be removed from the group.                                 |
| `message`  | string | No       | —       | The message to send to the removed members.                                        |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      },
      "memberId": {
        "type": "string",
        "description": "The ID of the member to be removed from the group."
      },
      "message": {
        "type": "string",
        "description": "The message to send to the removed members."
      }
    },
    "required": [
      "PCID",
      "groupId",
      "memberId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_create\_plan

Create Group Plan

**Parameters:**

| Parameter     | Type    | Required | Default | Description                               |
| ------------- | ------- | -------- | ------- | ----------------------------------------- |
| `description` | string  | No       | —       | The description of the group plan.        |
| `gems`        | integer | No       | —       | The number of gems required for the plan. |
| `interval`    | string  | No       | —       | The interval of the plan in cron syntax.  |
| `name`        | string  | No       | —       | The name of the group plan.               |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "description": {
        "type": "string",
        "description": "The description of the group plan."
      },
      "gems": {
        "type": "integer",
        "description": "The number of gems required for the plan."
      },
      "interval": {
        "type": "string",
        "description": "The interval of the plan in cron syntax."
      },
      "name": {
        "type": "string",
        "description": "The name of the group plan."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_groups\_party\_chat

Send a chat message to the party

**Parameters:**

| Parameter     | Type   | Required | Default | Description                                                                        |
| ------------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------- |
| `previousMsg` | string | No       | —       | The previous chat message's UUID which will force a return of the full group chat. |
| `message`     | string | No       | —       | The content of the chat message.                                                   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "previousMsg": {
        "type": "string",
        "description": "The previous chat message's UUID which will force a return of the full group chat."
      },
      "message": {
        "type": "string",
        "description": "The content of the chat message."
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_members\_send\_private\_message

Send Private Message

**Parameters:**

| Parameter  | Type   | Required | Default | Description                                            |
| ---------- | ------ | -------- | ------- | ------------------------------------------------------ |
| `message`  | string | Yes      | —       | The private message to be sent.                        |
| `toUserId` | string | Yes      | —       | The UUID of the user to whom the message will be sent. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "message": {
        "type": "string",
        "description": "The private message to be sent."
      },
      "toUserId": {
        "type": "string",
        "description": "The UUID of the user to whom the message will be sent."
      }
    },
    "required": [
      "PCID",
      "message",
      "toUserId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_create\_members\_transfer\_gems

Transfer Gems

**Parameters:**

| Parameter   | Type    | Required | Default | Description                  |
| ----------- | ------- | -------- | ------- | ---------------------------- |
| `gemAmount` | integer | Yes      | —       | The number of gems to send   |
| `message`   | string  | No       | —       | The message to the user      |
| `toUserId`  | string  | Yes      | —       | The user to send the gift to |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "gemAmount": {
        "type": "integer",
        "description": "The number of gems to send"
      },
      "message": {
        "type": "string",
        "description": "The message to the user"
      },
      "toUserId": {
        "type": "string",
        "description": "The user to send the gift to"
      }
    },
    "required": [
      "PCID",
      "gemAmount",
      "toUserId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_delete\_challenges\_by\_challenge\_id

Delete a challenge

**Parameters:**

| Parameter     | Type   | Required | Default | Description                     |
| ------------- | ------ | -------- | ------- | ------------------------------- |
| `challengeId` | string | Yes      | —       | ID of the challenge to retrieve |

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

***

## habitica\_social\_delete\_groups\_by\_group\_id\_chat\_by\_chat\_id

Delete chat message from a group

**Parameters:**

| Parameter     | Type   | Required | Default | Description                                                                                                                                |
| ------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `groupId`     | string | Yes      | —       | The group id ('party' for the user party and 'habitrpg' for tavern are accepted)                                                           |
| `chatId`      | string | Yes      | —       | The UUID of the chat message to delete.                                                                                                    |
| `previousMsg` | string | No       | —       | The last message's ID fetched by the client so that the whole chat will be returned only if new messages have been posted in the meantime. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      },
      "chatId": {
        "type": "string",
        "description": "The UUID of the chat message to delete."
      },
      "previousMsg": {
        "type": "string",
        "description": "The last message's ID fetched by the client so that the whole chat will be returned only if new messages have been posted in the meantime."
      }
    },
    "required": [
      "PCID",
      "groupId",
      "chatId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_get\_challenges\_by\_challenge\_id

Get challenges for a group

**Parameters:**

| Parameter     | Type   | Required | Default | Description                     |
| ------------- | ------ | -------- | ------- | ------------------------------- |
| `challengeId` | string | Yes      | —       | ID of the challenge to retrieve |

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

***

## habitica\_social\_get\_challenges\_by\_challenge\_id\_export\_csv

Export Challenge to CSV

**Parameters:**

| Parameter     | Type   | Required | Default | Description                   |
| ------------- | ------ | -------- | ------- | ----------------------------- |
| `challengeId` | string | Yes      | —       | ID of the challenge to export |

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

***

## habitica\_social\_get\_challenges\_by\_challenge\_id\_members

Get members for a challenge

**Parameters:**

| Parameter                | Type    | Required | Default | Description                                                                                                                |
| ------------------------ | ------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
| `challengeId`            | string  | Yes      | —       | The UUID of the challenge whose members are to be retrieved.                                                               |
| `lastId`                 | string  | No       | —       | Query parameter to specify the last member returned in a previous request to this route and get the next batch of results. |
| `limit`                  | integer | No       | —       | BETA Query parameter to specify the number of results to return. Max is 60.                                                |
| `includeTasks`           | boolean | No       | —       | BETA Query parameter - If 'true' then include challenge tasks of each member.                                              |
| `includeAllPublicFields` | boolean | No       | —       | If set to true then all public fields for members will be returned (similar to when making a request for a single member). |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "challengeId": {
        "type": "string",
        "description": "The UUID of the challenge whose members are to be retrieved."
      },
      "lastId": {
        "type": "string",
        "description": "Query parameter to specify the last member returned in a previous request to this route and get the next batch of results."
      },
      "limit": {
        "type": "integer",
        "description": "BETA Query parameter to specify the number of results to return. Max is 60."
      },
      "includeTasks": {
        "type": "boolean",
        "description": "BETA Query parameter - If 'true' then include challenge tasks of each member."
      },
      "includeAllPublicFields": {
        "type": "boolean",
        "description": "If set to true then all public fields for members will be returned (similar to when making a request for a single member)."
      }
    },
    "required": [
      "PCID",
      "challengeId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_get\_challenges\_by\_challenge\_id\_members\_by\_member\_id

Get a challenge member progress

**Parameters:**

| Parameter     | Type   | Required | Default | Description                     |
| ------------- | ------ | -------- | ------- | ------------------------------- |
| `challengeId` | string | Yes      | —       | The ID of the challenge.        |
| `memberId`    | string | Yes      | —       | The ID of the challenge member. |

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

***

## habitica\_social\_get\_challenges\_groups\_by\_group\_id

Get challenges for a group

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                       |
| --------- | ------ | -------- | ------- | --------------------------------------------------------------------------------- |
| `groupId` | string | Yes      | —       | The group id ('party' for the user party and 'habitrpg' for tavern are accepted). |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)."
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_get\_challenges\_user

Get challenges for a user

**Parameters:**

| Parameter    | Type   | Required | Default | Description                                                                                                                                    |
| ------------ | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `page`       | number | Yes      | —       | This parameter can be used to specify the page number for the user challenges result (the initial page is number 0).                           |
| `member`     | string | No       | —       | If set to true it limits results to challenges where the user is a member.                                                                     |
| `owned`      | string | No       | —       | If set to owned it limits results to challenges owned by the user. If set to not\_owned it limits results to challenges not owned by the user. |
| `search`     | string | No       | —       | Optional query parameter to filter results to challenges that include (even partially) the search query parameter in the name or description.  |
| `categories` | string | No       | —       | Optional comma separated list of categories. If set it limits results to challenges that are part of the given categories.                     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "page": {
        "type": "number",
        "description": "This parameter can be used to specify the page number for the user challenges result (the initial page is number 0)."
      },
      "member": {
        "type": "string",
        "description": "If set to true it limits results to challenges where the user is a member."
      },
      "owned": {
        "type": "string",
        "description": "If set to owned it limits results to challenges owned by the user. If set to not_owned it limits results to challenges not owned by the user."
      },
      "search": {
        "type": "string",
        "description": "Optional query parameter to filter results to challenges that include (even partially) the search query parameter in the name or description."
      },
      "categories": {
        "type": "string",
        "description": "Optional comma separated list of categories. If set it limits results to challenges that are part of the given categories."
      }
    },
    "required": [
      "PCID",
      "page"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_get\_group\_plans

Get Group Plans

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

***

## habitica\_social\_get\_groups

Get user's groups

**Parameters:**

| Parameter  | Type    | Required | Default | Description                                                                     |
| ---------- | ------- | -------- | ------- | ------------------------------------------------------------------------------- |
| `type`     | string  | Yes      | —       | Type of groups to retrieve (party, guilds, privateGuilds, publicGuilds, tavern) |
| `paginate` | boolean | No       | —       | Whether to paginate the results (true or false)                                 |
| `page`     | integer | No       | —       | Page number for paginated results (if paginate is true)                         |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "type": {
        "type": "string",
        "description": "Type of groups to retrieve (party, guilds, privateGuilds, publicGuilds, tavern)",
        "enum": [
          "party",
          "guilds",
          "privateGuilds",
          "publicGuilds",
          "tavern"
        ]
      },
      "paginate": {
        "type": "boolean",
        "description": "Whether to paginate the results (true or false)"
      },
      "page": {
        "type": "integer",
        "description": "Page number for paginated results (if paginate is true)"
      }
    },
    "required": [
      "PCID",
      "type"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_get\_groups\_by\_group\_id

Get group information

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                        |
| --------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------- |
| `groupId` | string | Yes      | —       | The group \_id ('party' for the user party and 'habitrpg' for tavern are accepted) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_get\_groups\_by\_group\_id\_chat

Get group chat messages

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                      |
| --------- | ------ | -------- | ------- | -------------------------------------------------------------------------------- |
| `groupId` | string | Yes      | —       | The group id ('party' for the user party and 'habitrpg' for tavern are accepted) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_get\_groups\_by\_group\_id\_invites

Get invites for a group

**Parameters:**

| Parameter                | Type    | Required | Default | Description                                                                                                                  |
| ------------------------ | ------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `groupId`                | string  | Yes      | —       | The group id ('party' for the user party is accepted)                                                                        |
| `lastId`                 | string  | No       | —       | Query parameter to specify the last invite returned in a previous request to this route and get the next batch of results.   |
| `limit`                  | integer | No       | —       | BETA Query parameter to specify the number of results to return. Max is 60.                                                  |
| `includeAllPublicFields` | boolean | No       | —       | If set to `true` then all public fields for members will be returned (similar to when making a request for a single member). |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group id ('party' for the user party is accepted)"
      },
      "lastId": {
        "type": "string",
        "description": "Query parameter to specify the last invite returned in a previous request to this route and get the next batch of results."
      },
      "limit": {
        "type": "integer",
        "description": "BETA Query parameter to specify the number of results to return. Max is 60."
      },
      "includeAllPublicFields": {
        "type": "boolean",
        "description": "If set to `true` then all public fields for members will be returned (similar to when making a request for a single member)."
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_get\_groups\_by\_group\_id\_members

Get members for a group

**Parameters:**

| Parameter                | Type    | Required | Default | Description                                                                                                                |
| ------------------------ | ------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
| `groupId`                | string  | Yes      | —       | The group id ('party' for the user party is accepted)                                                                      |
| `lastId`                 | string  | No       | —       | Query parameter to specify the last member returned in a previous request to this route and get the next batch of results. |
| `limit`                  | integer | No       | —       | BETA Query parameter to specify the number of results to return. Max is 60.                                                |
| `includeTasks`           | boolean | No       | —       | BETA Query parameter - If 'true' then include challenge tasks of each member.                                              |
| `includeAllPublicFields` | boolean | No       | —       | If set to true then all public fields for members will be returned (similar to when making a request for a single member). |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group id ('party' for the user party is accepted)"
      },
      "lastId": {
        "type": "string",
        "description": "Query parameter to specify the last member returned in a previous request to this route and get the next batch of results."
      },
      "limit": {
        "type": "integer",
        "description": "BETA Query parameter to specify the number of results to return. Max is 60."
      },
      "includeTasks": {
        "type": "boolean",
        "description": "BETA Query parameter - If 'true' then include challenge tasks of each member."
      },
      "includeAllPublicFields": {
        "type": "boolean",
        "description": "If set to true then all public fields for members will be returned (similar to when making a request for a single member)."
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_get\_groups\_party\_chat

Get party chat messages

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

***

## habitica\_social\_get\_looking\_for\_party

Get users in search of parties

**Parameters:**

| Parameter | Type   | Required | Default | Description                 |
| --------- | ------ | -------- | ------- | --------------------------- |
| `page`    | number | No       | —       | Page number, defaults to 0. |

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

***

## habitica\_social\_get\_members\_by\_member\_id

Get habitica member by ID

**Parameters:**

| Parameter  | Type   | Required | Default | Description                  |
| ---------- | ------ | -------- | ------- | ---------------------------- |
| `memberId` | string | Yes      | —       | ID of the member to retrieve |

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

***

## habitica\_social\_get\_members\_by\_member\_id\_achievements

Get member achievements object

**Parameters:**

| Parameter  | Type   | Required | Default | Description                                                  |
| ---------- | ------ | -------- | ------- | ------------------------------------------------------------ |
| `memberId` | string | Yes      | —       | The ID of the member whose achievements are to be retrieved. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "memberId": {
        "type": "string",
        "description": "The ID of the member whose achievements are to be retrieved."
      }
    },
    "required": [
      "PCID",
      "memberId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_get\_members\_by\_to\_user\_id\_objections\_by\_interaction

Get objections to interaction

**Parameters:**

| Parameter     | Type   | Required | Default | Description                       |
| ------------- | ------ | -------- | ------- | --------------------------------- |
| `toUserId`    | string | Yes      | —       | The user to interact with         |
| `interaction` | string | Yes      | —       | Name of the interaction to query. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "toUserId": {
        "type": "string",
        "description": "The user to interact with"
      },
      "interaction": {
        "type": "string",
        "description": "Name of the interaction to query.",
        "enum": [
          "send-private-message",
          "transfer-gems"
        ]
      }
    },
    "required": [
      "PCID",
      "toUserId",
      "interaction"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_update\_challenges\_by\_challenge\_id

Update a challenge

**Parameters:**

| Parameter     | Type   | Required | Default | Description                         |
| ------------- | ------ | -------- | ------- | ----------------------------------- |
| `challengeId` | string | Yes      | —       | ID of the challenge to retrieve     |
| `description` | string | No       | —       | The new challenge description.      |
| `name`        | string | No       | —       | The new full name of the challenge. |
| `summary`     | string | No       | —       | The new challenge summary.          |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "challengeId": {
        "type": "string",
        "description": "ID of the challenge to retrieve"
      },
      "description": {
        "type": "string",
        "description": "The new challenge description."
      },
      "name": {
        "type": "string",
        "description": "The new full name of the challenge."
      },
      "summary": {
        "type": "string",
        "description": "The new challenge summary."
      }
    },
    "required": [
      "PCID",
      "challengeId"
    ]
  }
  ```
</Expandable>

***

## habitica\_social\_update\_groups\_by\_group\_id

Update Group

**Parameters:**

| Parameter | Type   | Required | Default | Description                                                                        |
| --------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------- |
| `groupId` | string | Yes      | —       | The group \_id ('party' for the user party and 'habitrpg' for tavern are accepted) |
| `name`    | string | No       | —       | The name of the new group.                                                         |
| `privacy` | string | No       | —       | Privacy of group (party MUST be private)                                           |
| `type`    | string | No       | —       | Type of group (guild or party)                                                     |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "groupId": {
        "type": "string",
        "description": "The group _id ('party' for the user party and 'habitrpg' for tavern are accepted)"
      },
      "name": {
        "type": "string",
        "description": "The name of the new group."
      },
      "privacy": {
        "type": "string",
        "description": "Privacy of group (party MUST be private)",
        "enum": [
          "private",
          "public"
        ]
      },
      "type": {
        "type": "string",
        "description": "Type of group (guild or party)",
        "enum": [
          "guild",
          "party"
        ]
      }
    },
    "required": [
      "PCID",
      "groupId"
    ]
  }
  ```
</Expandable>