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

# account

> Manage organization members, invitations, permissions, personas, and sub-organizations

**Server path:** `/pf-account` | **Type:** Embedded | **PCID required:** No

## Tools

| Tool                                                          | Description                                                                                                                                                                                                             |
| ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [`pf_account_list_orgs`](#pf_account_list_orgs)               | List all organizations the current user belongs to, including sub-org hierarchy (parent/child relationships) and subscription types (e.g. Enterprise Prime / Enterprise Sub).                                           |
| [`pf_account_create_sub_org`](#pf_account_create_sub_org)     | Create a new sub-organization under the current organization. Requires enterprise plan and admin permission on the parent org.                                                                                          |
| [`pf_account_update_org`](#pf_account_update_org)             | Update an organization's name, email, or log levels. Requires admin permission on the org.                                                                                                                              |
| [`pf_account_list_org_members`](#pf_account_list_org_members) | List all active members of the current organization with their permissions (Admin/Member) and personas (Builder/End User).                                                                                              |
| [`pf_account_edit_member`](#pf_account_edit_member)           | Update an organization member's permission (ADMINISTER/WRITE/READ) and/or persona (builder/user). Requires admin permission.                                                                                            |
| [`pf_account_remove_member`](#pf_account_remove_member)       | Remove a member from the current organization by revoking their permission. Requires admin permission.                                                                                                                  |
| [`pf_account_invite_users`](#pf_account_invite_users)         | Invite a user to the current organization by email. If the user already exists and is not a member, they are added directly. Otherwise, an invitation email is sent. Requires admin permission. Subject to seat limits. |
| [`pf_account_list_invitations`](#pf_account_list_invitations) | List all pending invitations for the current organization.                                                                                                                                                              |
| [`pf_account_edit_invitation`](#pf_account_edit_invitation)   | Update a pending invitation's permission and/or persona, or revoke it by setting permission to "None". Requires admin permission.                                                                                       |

***

## pf\_account\_list\_orgs

List all organizations the current user belongs to, including sub-org hierarchy (parent/child relationships) and subscription types (e.g. Enterprise Prime / Enterprise Sub).

**Parameters:** None

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {}
  }
  ```
</Expandable>

***

## pf\_account\_create\_sub\_org

Create a new sub-organization under the current organization. Requires enterprise plan and admin permission on the parent org.

**Parameters:**

| Parameter | Type   | Required | Default | Description                        |
| --------- | ------ | -------- | ------- | ---------------------------------- |
| `name`    | string | Yes      | —       | Name for the new sub-organization  |
| `email`   | string | No       | —       | Email for the new sub-organization |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "name": {
        "type": "string",
        "description": "Name for the new sub-organization"
      },
      "email": {
        "type": "string",
        "description": "Email for the new sub-organization"
      }
    },
    "required": [
      "name"
    ]
  }
  ```
</Expandable>

***

## pf\_account\_update\_org

Update an organization's name, email, or log levels. Requires admin permission on the org.

**Parameters:**

| Parameter      | Type   | Required | Default | Description                       |
| -------------- | ------ | -------- | ------- | --------------------------------- |
| `orgId`        | string | Yes      | —       | The organization ID to update     |
| `name`         | string | No       | —       | New name for the organization     |
| `email`        | string | No       | —       | New email for the organization    |
| `devLogLevel`  | string | No       | —       | Development environment log level |
| `prodLogLevel` | string | No       | —       | Production environment log level  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "orgId": {
        "type": "string",
        "description": "The organization ID to update"
      },
      "name": {
        "type": "string",
        "description": "New name for the organization"
      },
      "email": {
        "type": "string",
        "description": "New email for the organization"
      },
      "devLogLevel": {
        "type": "string",
        "enum": [
          "minimal",
          "standard",
          "verbose"
        ],
        "description": "Development environment log level"
      },
      "prodLogLevel": {
        "type": "string",
        "enum": [
          "minimal",
          "standard",
          "verbose"
        ],
        "description": "Production environment log level"
      }
    },
    "required": [
      "orgId"
    ]
  }
  ```
</Expandable>

***

## pf\_account\_list\_org\_members

List all active members of the current organization with their permissions (Admin/Member) and personas (Builder/End User).

**Parameters:** None

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {}
  }
  ```
</Expandable>

***

## pf\_account\_edit\_member

Update an organization member's permission (ADMINISTER/WRITE/READ) and/or persona (builder/user). Requires admin permission.

**Parameters:**

| Parameter       | Type   | Required | Default | Description                                                             |
| --------------- | ------ | -------- | ------- | ----------------------------------------------------------------------- |
| `userAccountId` | string | Yes      | —       | The account ID of the member to update                                  |
| `permission`    | string | No       | —       | New permission level for the member                                     |
| `persona`       | string | No       | —       | New persona for the member (builder = build mode, user = end-user mode) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "userAccountId": {
        "type": "string",
        "description": "The account ID of the member to update"
      },
      "permission": {
        "type": "string",
        "enum": [
          "ADMINISTER",
          "WRITE",
          "READ"
        ],
        "description": "New permission level for the member"
      },
      "persona": {
        "type": "string",
        "enum": [
          "builder",
          "user"
        ],
        "description": "New persona for the member (builder = build mode, user = end-user mode)"
      }
    },
    "required": [
      "userAccountId"
    ]
  }
  ```
</Expandable>

***

## pf\_account\_remove\_member

Remove a member from the current organization by revoking their permission. Requires admin permission.

**Parameters:**

| Parameter       | Type   | Required | Default | Description                            |
| --------------- | ------ | -------- | ------- | -------------------------------------- |
| `userAccountId` | string | Yes      | —       | The account ID of the member to remove |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "userAccountId": {
        "type": "string",
        "description": "The account ID of the member to remove"
      }
    },
    "required": [
      "userAccountId"
    ]
  }
  ```
</Expandable>

***

## pf\_account\_invite\_users

Invite a user to the current organization by email. If the user already exists and is not a member, they are added directly. Otherwise, an invitation email is sent. Requires admin permission. Subject to seat limits.

**Parameters:**

| Parameter    | Type   | Required | Default | Description                                                                                     |
| ------------ | ------ | -------- | ------- | ----------------------------------------------------------------------------------------------- |
| `email`      | string | Yes      | —       | Email address of the user to invite                                                             |
| `permission` | string | Yes      | —       | Permission level for the invited user                                                           |
| `persona`    | string | No       | —       | Persona for the invited user (builder = build mode, user = end-user mode). Defaults to builder. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "email": {
        "type": "string",
        "description": "Email address of the user to invite"
      },
      "permission": {
        "type": "string",
        "enum": [
          "ADMINISTER",
          "WRITE",
          "READ"
        ],
        "description": "Permission level for the invited user"
      },
      "persona": {
        "type": "string",
        "enum": [
          "builder",
          "user"
        ],
        "description": "Persona for the invited user (builder = build mode, user = end-user mode). Defaults to builder."
      }
    },
    "required": [
      "email",
      "permission"
    ]
  }
  ```
</Expandable>

***

## pf\_account\_list\_invitations

List all pending invitations for the current organization.

**Parameters:** None

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {}
  }
  ```
</Expandable>

***

## pf\_account\_edit\_invitation

Update a pending invitation's permission and/or persona, or revoke it by setting permission to "None". Requires admin permission.

**Parameters:**

| Parameter      | Type   | Required | Default | Description                                                |
| -------------- | ------ | -------- | ------- | ---------------------------------------------------------- |
| `invitationId` | string | Yes      | —       | The invitation ID to update                                |
| `permission`   | string | No       | —       | New permission level. Use "NONE" to revoke the invitation. |
| `persona`      | string | No       | —       | New persona for the invited user                           |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "invitationId": {
        "type": "string",
        "description": "The invitation ID to update"
      },
      "permission": {
        "type": "string",
        "enum": [
          "ADMINISTER",
          "WRITE",
          "READ",
          "NONE"
        ],
        "description": "New permission level. Use \"NONE\" to revoke the invitation."
      },
      "persona": {
        "type": "string",
        "enum": [
          "builder",
          "user"
        ],
        "description": "New persona for the invited user"
      }
    },
    "required": [
      "invitationId"
    ]
  }
  ```
</Expandable>