v1

latestOpenAPI 3.1.02026-07-265094114.0 KB
Knowledge

Search Knowledge

Searches through your Knowledge Base and returns items most relevant to the provided query. This endpoint is designed to support natural language search, allowing you to find Knowledge based on meaning and context—not just exact keyword matches.

post/v1/knowledge/search

Request body

querystring required

The search query to find relevant Knowledge items. Supports natural language search.

Example request

{
  "query": "What are my brand guidelines for social media posts?"
}

Response

Successfully retrieved list of Knowledge by relevance to the query.

requestIdstring
resourcestring

Example response

{
  "requestId": "bce766ea-a4ef-48e5-9da1d9602bfecf2d",
  "resource": "knowledge",
  "data": [
    {
      "id": "kno_2ee766eaa4ef48e59da1d9602bfecf2d",
      "name": "Brand Guidelines Document",
      "summary": "Comprehensive brand guidelines including logo usage, color palette, and typography standards.",
      "tags": [
        "branding",
        "guidelines",
        "logo"
      ],
      "relevantChunks": [
        {
          "content": "Brand guidelines specify that our logo should always maintain a minimum clear space equivalent to the height of the \"J\" in our wordmark.",
          "score": 0.85
        }
      ]
    }
  ]
}