{
  "info": {
    "name": "Charla — mcp.ai",
    "description": "REST API for the Charla MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/charla",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "charla_create_kb_article",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/kb/article",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "kb",
            "article"
          ]
        },
        "description": "Create a knowledge base article. Charla generates its URL slug from the title and may use it for chatbot training according to the property's AI settings. Defaults to a private draft.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"title\": \"\",\n  \"status\": \"\",\n  \"visibility\": \"\",\n  \"description\": \"\",\n  \"category_ids\": \"\",\n  \"content_html\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "charla_delete_kb_article",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/kb/article",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "kb",
            "article"
          ]
        },
        "description": "Permanently delete one knowledge base article by ID. This cannot be undone, and deleting an already-missing article fails.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"article_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "charla_get_contact",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/contact",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "contact"
          ]
        },
        "description": "Return one contact in the connected Charla property by UUID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"contact_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "charla_get_kb_article",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/kb/article",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "kb",
            "article"
          ]
        },
        "description": "Return the full content and metadata of one knowledge base article by ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"article_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "charla_list_contacts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/contacts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "contacts"
          ]
        },
        "description": "Return one page of contacts for the connected Charla property, ordered by most recently modified.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "charla_list_conversations",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/conversations",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "conversations"
          ]
        },
        "description": "Export one page of conversations grouped by contact for the connected Charla property, including message history.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "charla_list_kb_articles",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/kb/articles",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "kb",
            "articles"
          ]
        },
        "description": "Return one page of knowledge base article summaries for the connected Charla property, newest first.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"cursor\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "charla_list_kb_categories",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/kb/categories",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "kb",
            "categories"
          ]
        },
        "description": "Return all knowledge base categories available in the connected Charla property.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "charla_update_kb_article",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/kb/article",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "kb",
            "article"
          ]
        },
        "description": "Replace every writable field of an existing knowledge base article. Charla regenerates the URL slug from the replacement title and may retrain chatbot content according to the property's AI settings.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"title\": \"\",\n  \"status\": \"\",\n  \"article_id\": 0,\n  \"visibility\": \"\",\n  \"description\": \"\",\n  \"category_ids\": \"\",\n  \"content_html\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}