Skip to main content
GET
/
v3
/
ai-sdr
/
knowledge-bases
/
{knowledge_base_id}
/
reply-handlers
/
{reply_handler_id}
Get a reply handler
curl --request GET \
  --url https://api.reply.io/v3/ai-sdr/knowledge-bases/{knowledge_base_id}/reply-handlers/{reply_handler_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "9c1f8a7e-0b3a-4d11-9b9c-2c4f8a7e0b3a",
  "typeOfQuestion": "Pricing inquiry",
  "instructions": "Quote our published tiered pricing; offer a discovery call for enterprise.",
  "sampleAnswer": "Thanks for asking! Our tiered pricing starts at $X...",
  "toneOfVoice": "confident",
  "responseLength": "medium",
  "links": [
    "https://example.com/pricing"
  ],
  "media": [
    {
      "id": 12345,
      "fileName": "pricing-tiers.png",
      "size": 248
    }
  ],
  "isAutoSend": false,
  "createdAt": "2026-05-10T14:32:11Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.reply.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Path Parameters

​
knowledge_base_id
integer<int64>
required
Required range: x >= 1
​
reply_handler_id
string<uuid>
required

Response

Reply handler found

Detailed representation of a reply handler.

​
id
string<uuid>
read-only

Unique identifier for the reply handler

​
typeOfQuestion
string

Short label describing the type of incoming reply this handler covers

​
instructions
string

Instructions for how to handle replies of this type

​
sampleAnswer
string

Optional sample answer used as a few-shot example

​
toneOfVoice
enum<string>

Tone applied to generated replies

Available options:
confident,
persuasive,
witty,
straightforward,
empathetic
​
responseLength
enum<string>

Target length for generated replies

Available options:
superShort,
short,
medium,
long
​
links
string[]

Reference URLs the AI SDR can quote when generating a reply

​
media
KnowledgeBaseMedia · object[]
read-only

Media items attached to this reply handler. Managed via the /media sub-resource.

​
isAutoSend
boolean

Whether replies matching this handler should be auto-sent without manual review

​
createdAt
string<date-time>
read-only

Timestamp when the reply handler was created