> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# gist-knowledge

> Gist Knowledge Base - manage articles and collections

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

## Tools

| Tool                                                                                      | Description                |
| ----------------------------------------------------------------------------------------- | -------------------------- |
| [`gist_knowledge_create_article`](#gist_knowledge_create_article)                         | Create an article          |
| [`gist_knowledge_create_collection`](#gist_knowledge_create_collection)                   | Create a collection        |
| [`gist_knowledge_delete_article`](#gist_knowledge_delete_article)                         | Delete an article          |
| [`gist_knowledge_delete_collection`](#gist_knowledge_delete_collection)                   | Delete a collection        |
| [`gist_knowledge_get_article`](#gist_knowledge_get_article)                               | Retrieve an article        |
| [`gist_knowledge_get_collection`](#gist_knowledge_get_collection)                         | Retrieve a collection      |
| [`gist_knowledge_get_knowledgebase_settings`](#gist_knowledge_get_knowledgebase_settings) | Get knowledgebase settings |
| [`gist_knowledge_list_articles`](#gist_knowledge_list_articles)                           | List all articles          |
| [`gist_knowledge_list_collections`](#gist_knowledge_list_collections)                     | List all collections       |
| [`gist_knowledge_search_articles`](#gist_knowledge_search_articles)                       | Search articles            |
| [`gist_knowledge_update_article`](#gist_knowledge_update_article)                         | Update an article          |
| [`gist_knowledge_update_collection`](#gist_knowledge_update_collection)                   | Update a collection        |

***

## gist\_knowledge\_create\_article

Create an article

**Parameters:**

| Parameter       | Type       | Required | Default | Description                                                                                                                                                                    |
| --------------- | ---------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `parent_id`     | integer    | No       | —       | Parent article ID                                                                                                                                                              |
| `secondary_ids` | integer\[] | No       | —       | Secondary collection IDs                                                                                                                                                       |
| `translations`  | object     | Yes      | —       | Translations keyed by locale. Each translation has: author\_id (required), title (required), html\_text (required), description (optional), status (required: published/draft) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "parent_id": {
        "type": "integer",
        "description": "Parent article ID"
      },
      "secondary_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Secondary collection IDs"
      },
      "translations": {
        "type": "object",
        "description": "Translations keyed by locale. Each translation has: author_id (required), title (required), html_text (required), description (optional), status (required: published/draft)"
      }
    },
    "required": [
      "PCID",
      "translations"
    ]
  }
  ```
</Expandable>

***

## gist\_knowledge\_create\_collection

Create a collection

**Parameters:**

| Parameter      | Type    | Required | Default | Description                                                                                      |
| -------------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------------------ |
| `parent_id`    | integer | No       | —       | Parent collection ID                                                                             |
| `translations` | object  | Yes      | —       | Translations keyed by locale. Each has: name (required), description (required), icon (required) |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "parent_id": {
        "type": "integer",
        "description": "Parent collection ID"
      },
      "translations": {
        "type": "object",
        "description": "Translations keyed by locale. Each has: name (required), description (required), icon (required)"
      }
    },
    "required": [
      "PCID",
      "translations"
    ]
  }
  ```
</Expandable>

***

## gist\_knowledge\_delete\_article

Delete an article

**Parameters:**

| Parameter | Type    | Required | Default | Description |
| --------- | ------- | -------- | ------- | ----------- |
| `id`      | integer | Yes      | —       | Article ID  |

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

***

## gist\_knowledge\_delete\_collection

Delete a collection

**Parameters:**

| Parameter | Type   | Required | Default | Description   |
| --------- | ------ | -------- | ------- | ------------- |
| `id`      | string | Yes      | —       | Collection ID |

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

***

## gist\_knowledge\_get\_article

Retrieve an article

**Parameters:**

| Parameter | Type    | Required | Default | Description |
| --------- | ------- | -------- | ------- | ----------- |
| `id`      | integer | Yes      | —       | Article ID  |

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

***

## gist\_knowledge\_get\_collection

Retrieve a collection

**Parameters:**

| Parameter | Type   | Required | Default | Description   |
| --------- | ------ | -------- | ------- | ------------- |
| `id`      | string | Yes      | —       | Collection ID |

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

***

## gist\_knowledge\_get\_knowledgebase\_settings

Get knowledgebase settings

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

***

## gist\_knowledge\_list\_articles

List all articles

**Parameters:**

| Parameter       | Type    | Required | Default | Description                       |
| --------------- | ------- | -------- | ------- | --------------------------------- |
| `page`          | integer | No       | —       | Page number                       |
| `per_page`      | integer | No       | —       | Results per page (max 60)         |
| `order`         | string  | No       | —       | Sort order                        |
| `order_by`      | string  | No       | —       | Sort field (default: created\_at) |
| `status`        | string  | No       | —       | Filter by status                  |
| `collection_id` | string  | No       | —       | Filter by collection ID           |
| `author_id`     | string  | No       | —       | Filter by author ID               |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      },
      "per_page": {
        "type": "integer",
        "description": "Results per page (max 60)"
      },
      "order": {
        "type": "string",
        "description": "Sort order",
        "enum": [
          "asc",
          "desc"
        ]
      },
      "order_by": {
        "type": "string",
        "description": "Sort field (default: created_at)"
      },
      "status": {
        "type": "string",
        "description": "Filter by status",
        "enum": [
          "published",
          "draft"
        ]
      },
      "collection_id": {
        "type": "string",
        "description": "Filter by collection ID"
      },
      "author_id": {
        "type": "string",
        "description": "Filter by author ID"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## gist\_knowledge\_list\_collections

List all collections

**Parameters:**

| Parameter  | Type    | Required | Default | Description               |
| ---------- | ------- | -------- | ------- | ------------------------- |
| `page`     | integer | No       | —       | Page number               |
| `per_page` | integer | No       | —       | Results per page (max 60) |
| `order`    | string  | No       | —       | Sort order                |
| `order_by` | string  | No       | —       | Sort field                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      },
      "per_page": {
        "type": "integer",
        "description": "Results per page (max 60)"
      },
      "order": {
        "type": "string",
        "description": "Sort order",
        "enum": [
          "asc",
          "desc"
        ]
      },
      "order_by": {
        "type": "string",
        "description": "Sort field"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## gist\_knowledge\_search\_articles

Search articles

**Parameters:**

| Parameter     | Type    | Required | Default | Description               |
| ------------- | ------- | -------- | ------- | ------------------------- |
| `search_text` | string  | Yes      | —       | Search query text         |
| `locale`      | string  | No       | —       | Locale to search in       |
| `page`        | integer | No       | —       | Page number               |
| `per_page`    | integer | No       | —       | Results per page (max 60) |
| `order`       | string  | No       | —       | Sort order                |
| `order_by`    | string  | No       | —       | Sort field                |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "search_text": {
        "type": "string",
        "description": "Search query text"
      },
      "locale": {
        "type": "string",
        "description": "Locale to search in"
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      },
      "per_page": {
        "type": "integer",
        "description": "Results per page (max 60)"
      },
      "order": {
        "type": "string",
        "description": "Sort order",
        "enum": [
          "asc",
          "desc"
        ]
      },
      "order_by": {
        "type": "string",
        "description": "Sort field"
      }
    },
    "required": [
      "PCID",
      "search_text"
    ]
  }
  ```
</Expandable>

***

## gist\_knowledge\_update\_article

Update an article

**Parameters:**

| Parameter        | Type       | Required | Default | Description                  |
| ---------------- | ---------- | -------- | ------- | ---------------------------- |
| `id`             | integer    | Yes      | —       | Article ID                   |
| `default_locale` | string     | No       | —       | Default locale               |
| `parent_id`      | integer    | No       | —       | Parent article ID            |
| `secondary_ids`  | integer\[] | No       | —       | Secondary collection IDs     |
| `translations`   | object     | No       | —       | Translations keyed by locale |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Article ID"
      },
      "default_locale": {
        "type": "string",
        "description": "Default locale"
      },
      "parent_id": {
        "type": "integer",
        "description": "Parent article ID"
      },
      "secondary_ids": {
        "type": "array",
        "items": {
          "type": "integer"
        },
        "description": "Secondary collection IDs"
      },
      "translations": {
        "type": "object",
        "description": "Translations keyed by locale"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## gist\_knowledge\_update\_collection

Update a collection

**Parameters:**

| Parameter      | Type    | Required | Default | Description                  |
| -------------- | ------- | -------- | ------- | ---------------------------- |
| `id`           | string  | Yes      | —       | Collection ID                |
| `description`  | string  | No       | —       | Collection description       |
| `icon`         | string  | No       | —       | Collection icon              |
| `name`         | string  | No       | —       | Collection name              |
| `parent_id`    | integer | No       | —       | Parent collection ID         |
| `translations` | object  | No       | —       | Translations keyed by locale |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "string",
        "description": "Collection ID"
      },
      "description": {
        "type": "string",
        "description": "Collection description"
      },
      "icon": {
        "type": "string",
        "description": "Collection icon"
      },
      "name": {
        "type": "string",
        "description": "Collection name"
      },
      "parent_id": {
        "type": "integer",
        "description": "Parent collection ID"
      },
      "translations": {
        "type": "object",
        "description": "Translations keyed by locale"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>