List suggestions

What the agent learned from resolved conversations, waiting for a person to say yes or no. Nothing lands in the library without an approval.

GET/knowledge/suggestions

Authorization

AuthorizationBearer token · headerrequired

`MEDIAN_KEY` from Settings under API, or an MCP OAuth access token. A key acts as the organization; a token acts as the person who approved it.

Responses

200The pending queue, newest first.

suggestionsobject[]

Show properties

Array of object

idstring

conversationIdstring

conversationSubjectstring

titlestring

bodystring

targetDocIdstring | null

targetTitlestring | null

suggestedAtinteger

401The bearer token is missing, revoked, or expired.

errorobject

Show properties

codestring

messagestring

429Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See [rate limits](/api/errors-and-limits#rate-limits).

errorobject

Show properties

codestring

messagestring

Request

curl -X GET "https://api.median.sh/v1/knowledge/suggestions" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.median.sh/v1/knowledge/suggestions", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

Response

{
  "suggestions": [
    {
      "id": "string",
      "conversationId": "string",
      "conversationSubject": "string",
      "title": "string",
      "body": "string",
      "targetDocId": "string",
      "targetTitle": "string",
      "suggestedAt": 0
    }
  ]
}