New: Kith open-sources its ATS.Read why
Skip to Content
Objects

Call

A recorded call or meeting, with its transcript. A call is stored once, however many people were on it: each candidate who was on it is linked to it (links). Calls arrive from a call recorder such as Granola, or as a pasted transcript. Once a call is linked to a candidate, everyone in the workspace can read it.

type Call {
  heldAt: DateTime
  id: ID!
  links(
    after: String
    before: String
    first: Int
    last: Int
  ): CallLinkConnection!
  participants: [CallParticipant!]!
  preview: String!
  roleCheck: CallRoleCheck
  segments: [CallSegment!]
  source: String!
  summary: String
  title: String
  transcript: String!
}

Fields

Call.heldAt · DateTime scalar

When the call took place. Null when the recorder did not say.

Call.id · ID! non-null scalar

The call's id.

The candidates this call is linked to, in the order they were linked. A link that has been removed is not listed, and nor is one to a candidate not yet released to the workspace.

Return the rows that follow this cursor.

Return the rows that come before this cursor.

How many rows to return, from the start or from after. 50 when left out, 200 at most.

How many rows to return, counting back from the end or from before. 200 at most.

Call.participants · [CallParticipant!]! non-null object

Who was on the call, as the recorder listed them. The workspace's own people are included.

Call.preview · String! non-null scalar

The first 280 characters of the transcript, for a list. Read transcript for the rest.

Call.roleCheck · CallRoleCheck object

The check of this call against the workspace's open jobs. Null when the call has never been checked: start one with startCallRoleCheck. A call attached from the unmatched list is checked without asking.

Call.segments · [CallSegment!] list object

The transcript as speaker turns, in the order spoken. Null when the recorder gave only plain text: use transcript then. A query asking for many calls' turns is refused as too complex.

Call.source · String! non-null scalar

Where the call came from: the recorder's name in lower case, such as granola, fathom, fireflies, otter or zoom, generic for another tool, or transcript for one pasted in.

Call.summary · String scalar

The recorder's own summary of the call, as Markdown. Null when it wrote none.

Call.title · String scalar

The call's title, as the recorder named it. Null when it gave none.

Call.transcript · String! non-null scalar

The whole transcript as plain text. It can run to tens of thousands of words: ask for it for one call at a time. A query asking for many is refused as too complex.

Returned By

call query

Member Of

AttachUnmatchedCallPayload object · AttachUnmatchedCallToNewCandidatePayload object · CallAction object · CallEdge object · CallLink object · Candidate object · StartCallRoleCheckPayload object · UnlinkCallFromCandidatePayload object

Shown in the UI

These components show it:

  • Call list: The calls linked to one person.
  • Call card: One call linked to a person, with its transcript.