Daybook DocsDaybook Docs
Book a demo
Browse
Book a demo

Tell the agent something

POST/v1/calls/{id}/instruct

Send the agent a line while the call is live: a fact it should know or a question to add. It is never spoken aloud.

Used in Payer calls

A note to the agent from your tool while the call is up: a biller watching the ticket adds "ask for the check number", or your system learns mid-call that the member's plan changed. The line shows in the transcript as an operator note and the agent works it into the conversation. It takes a call from dialing to with_rep; a call that has ended answers 409 conflict. Tell the agent in the Daybook app's Live calls does the same, for the item's owner and the firm's leads, up to 280 characters. See Payer calls.

Call this with AIA brief with this endpoint's request, response and auth, ready for a typed client in your language.

Path parameters

  • idstringrequired
    The call id.

Body

  • textstringrequired
    What the agent should know or ask. Up to 280 characters. Never said on the call as written.
Try itEdit the fields and copy the request. Nothing is sent from this page.
curl -X POST https://api.daybookhealthcare.com/v1/calls/call_01JBX8M4Q2T7/instruct \
  -H "Authorization: Bearer $DAYBOOK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "text": "Ask for the check number and the date it was mailed."
  }'

Response

  • idstring
    The call id.
  • objectstring
    Always call.
  • statusstring
    Where the call is now.
  • instructionsobject[]
    Every line sent to the agent on this call, oldest first: text and at.
curl -X POST https://api.daybookhealthcare.com/v1/calls/call_01JBX8M4Q2T7/instruct \
  -H "Authorization: Bearer $DAYBOOK_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "text": "Ask for the check number and the date it was mailed."
  }'
Response 200
{
  "id": "call_01JBX8M4Q2T7",
  "object": "call",
  "status": "with_rep",
  "instructions": [
    {
      "text": "Ask for the check number and the date it was mailed.",
      "at": "2026-10-29T14:28:03Z"
    }
  ]
}