# Search Marketplace Knowledge

`POST https://api.suger.cloud/org/{orgId}/knowledge/search`

Searches the shared knowledge index covering AWS, Azure, and GCP marketplace documentation, Fours docs, and internal support knowledge.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |

## Request Body

Required.

Content-Type: `application/json` · Schema: `SearchKnowledgeRequest`

**`SearchKnowledgeRequest`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `queryText` | string | yes |  |
| `searchMode` | string | no |  |
| `topK` | integer | no |  |

## Responses

### 200 — Knowledge search results

Content-Type: `application/json` · Schema: `SearchKnowledgeResponse`

**`SearchKnowledgeResponse`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `queryText` | string | no |  |
| `resultCount` | integer | no |  |
| `results` | array<SearchKnowledgeResult> | no |  |
| `searchMode` | string | no |  |

**`SearchKnowledgeResult`** fields:

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `confidence` | number | no |  |
| `content` | string | no |  |
| `id` | string | no |  |
| `section` | string | no |  |
| `source` | string | no |  |

### 400 — Bad request error

Content-Type: `application/json`

### 500 — Internal server error

Content-Type: `application/json`

## Example

_Generated from this operation's schema. Values are placeholders — substitute your own ids, and set `SUGER_TOKEN` to a bearer token from the [OAuth client-credentials exchange](https://doc.fours.com/settings/oauth-app/)._

### Request

```bash
curl -X POST 'https://api.suger.cloud/org/{orgId}/knowledge/search' \
  -H "Authorization: Bearer $SUGER_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "queryText": "string"
}'
```

### Response — 200

```json
{
  "queryText": "string",
  "resultCount": 1,
  "results": [
    {
      "confidence": 100,
      "content": "string",
      "id": "01H0000000000000000000",
      "section": "string",
      "source": "string"
    }
  ],
  "searchMode": "string"
}
```

### Error — 400

```json
"string"
```

---

API reference: https://doc.fours.com/api/