Skip to content

Interview

An Interview is one person’s pass through a question script, led by an Agent, whose answers become Evidence.

Its answers feed the Story word for word.

Properties

PropertyTypeRequiredDescription
scriptTemplaterequiredThe questions asked.
transcripttextWhat was said.
Inherited from Thread: 1 property
PropertyTypeRequiredDescription
subjectstringWhat the Thread is about.

Object

JSON
{
  "$id": "https://api.sb/routewise.dev/interviews/interview_1",
  "$type": "Interview",
  "subject": "Example subject",
  "script": "template_1",
  "transcript": "Example transcript"
}

Relationships

  • An Interview is quoted in many Stories: the Interviews whose words the Story reuses. quotedIn, inverse quotes.
  • An Interview yields many pieces of Evidence: an Interview captures quotes and commitments, each graded as Evidence. yields, inverse yieldedBy.

Verbs

  1. createCreates an Interview.
    POST /{namespace}/interviewsdoInterview.created
  2. getReturns one Interview by id.
    GET /{namespace}/interviews/{id}readNo Event
  3. listReturns Interviews, newest first, one page at a time.
    GET /{namespace}/interviewsreadNo Event

An Interview is kept forever and never edited: it has no update or delete.

Permissions

Which Access level may call each Verb. One-way Verbs wait their delay window.

Operationowneradminmemberviewer
Interview.createYesYesYesNo
Interview.getYesYesYesYes
Interview.listYesYesYesYes

Call it

Text
Add an interview to LedgerLark with a template.

Example

An Agent runs a five-question Interview with a music teacher about how she books lessons. Her answer, two lessons lost each week to text-message mixups, enters the transcript and becomes Evidence on the Problem.