Fetchply Docs
API reference
GET
/api/v1/agents/{id}/qa-pairs

List an agent's curated Q&A pairs, newest first, paged with limit/offset and filterable by kind. Requires the read:qa permission.

Authorization

BearerAuth read:qa
AuthorizationBearer <token>

In: header

Scope: read:qa

Path Parameters

id*string

Query Parameters

limit?integer
offset?integer
kind?string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/agents/string/qa-pairs"
{
  "items": [
    {
      "id": 7,
      "agentId": "a1b2c3d4e5",
      "kind": "qa",
      "question": "Do you ship internationally?",
      "answer": "Yes, we ship to over 40 countries. Delivery takes 5-10 days.",
      "enabled": true,
      "attachmentCount": 0,
      "createdAt": "2026-08-01T10:00:00.000Z",
      "updatedAt": null
    }
  ],
  "total": 0,
  "limit": 0,
  "offset": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "issues": [
    {
      "path": "string",
      "message": "string"
    }
  ]
}

Retrain an agent POST

Queue a background refresh of the agent's knowledge: known pages are re-read and new site pages are discovered. Poll `GET /agents/{id}/training-status` for progress. Requires the `write:sources` permission.

Create a Q&A pair POST

Add a curated question and answer the agent should serve verbatim. The pair is indexed in the background and starts matching shortly after. Requires the `write:qa` permission.