# Call (/api/reference/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.

```graphql
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 [#fields]

#### [`Call.heldAt`](#held-at) · [`DateTime`](/api/reference/scalars/date-time) `scalar` [#held-at]
When the call took place. Null when the recorder did not say.

#### [`Call.id`](#id) · [`ID!`](/api/reference/scalars/id) `non-null` `scalar` [#id]
The call's id.

#### [`Call.links`](#links) · [`CallLinkConnection!`](/api/reference/objects/call-link-connection) `non-null` `object` [#links]
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.
##### [`Call.links.after`](#call-links-after) · [`String`](/api/reference/scalars/string) `scalar` [#call-links-after]
Return the rows that follow this cursor.

##### [`Call.links.before`](#call-links-before) · [`String`](/api/reference/scalars/string) `scalar` [#call-links-before]
Return the rows that come before this cursor.

##### [`Call.links.first`](#call-links-first) · [`Int`](/api/reference/scalars/int) `scalar` [#call-links-first]
How many rows to return, from the start or from `after`. 50 when left out, 200 at most.

##### [`Call.links.last`](#call-links-last) · [`Int`](/api/reference/scalars/int) `scalar` [#call-links-last]
How many rows to return, counting back from the end or from `before`. 200 at most.

#### [`Call.participants`](#participants) · [`[CallParticipant!]!`](/api/reference/objects/call-participant) `non-null` `object` [#participants]
Who was on the call, as the recorder listed them. The workspace's own people are included.

#### [`Call.preview`](#preview) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#preview]
The first 280 characters of the transcript, for a list. Read `transcript` for the rest.

#### [`Call.roleCheck`](#role-check) · [`CallRoleCheck`](/api/reference/objects/call-role-check) `object` [#role-check]
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`](#segments) · [`[CallSegment!]`](/api/reference/objects/call-segment) `list` `object` [#segments]
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`](#source) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#source]
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`](#summary) · [`String`](/api/reference/scalars/string) `scalar` [#summary]
The recorder's own summary of the call, as Markdown. Null when it wrote none.

#### [`Call.title`](#title) · [`String`](/api/reference/scalars/string) `scalar` [#title]
The call's title, as the recorder named it. Null when it gave none.

#### [`Call.transcript`](#transcript) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#transcript]
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 [#returned-by]

[`call`](/api/reference/queries/call)  `query`

### Member Of [#member-of]

[`AttachUnmatchedCallPayload`](/api/reference/objects/attach-unmatched-call-payload)  `object` · [`AttachUnmatchedCallToNewCandidatePayload`](/api/reference/objects/attach-unmatched-call-to-new-candidate-payload)  `object` · [`CallAction`](/api/reference/objects/call-action)  `object` · [`CallEdge`](/api/reference/objects/call-edge)  `object` · [`CallLink`](/api/reference/objects/call-link)  `object` · [`Candidate`](/api/reference/objects/candidate)  `object` · [`StartCallRoleCheckPayload`](/api/reference/objects/start-call-role-check-payload)  `object` · [`UnlinkCallFromCandidatePayload`](/api/reference/objects/unlink-call-from-candidate-payload)  `object`

## Shown in the UI [#shown-in-the-ui]

These components show it:

- [Call list](/ui/candidate-call-list): The calls linked to one person.
- [Call card](/ui/candidate-call-card): One call linked to a person, with its transcript.