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

RelationshipSignal

A change in a candidate's or a company's situation that gives a recruiter a reason to get in touch: a job move, a promotion, a tenure milestone, a company hiring. This is not the evidence behind a grade: that is JobCandidateSignal.

type RelationshipSignal {
  actionLabel: String
  actionPath: String
  candidate: Candidate
  detectedAt: DateTime!
  evidence: RelationshipSignalEvidence!
  id: ID!
  kind: RelationshipSignalKind!
  priority: RelationshipSignalPriority!
  recommendedAction: String!
  snoozedUntil: DateTime
  status: RelationshipSignalStatus!
  whatChanged: String!
  whyItMatters: String!
}

Fields

RelationshipSignal.actionLabel · String scalar

The words for the button that takes the action, such as "Review matches". Null when the signal suggests no step inside the app.

RelationshipSignal.actionPath · String scalar

The path inside the app that the action opens, such as /jobs/12/source. Null when there is none.

RelationshipSignal.candidate · Candidate object

The candidate it is about. Null for a signal about a company.

RelationshipSignal.detectedAt · DateTime! non-null scalar

When Kith ATS first saw the change.

RelationshipSignal.evidence · RelationshipSignalEvidence! non-null object

The facts behind the signal that the app shows beside it.

RelationshipSignal.id · ID! non-null scalar

The signal's id.

RelationshipSignal.kind · RelationshipSignalKind! non-null enum

What kind of change it is.

RelationshipSignal.priority · RelationshipSignalPriority! non-null enum

How soon it deserves attention.

What to do about it, in a sentence.

RelationshipSignal.snoozedUntil · DateTime scalar

When a snoozed signal comes back. Null unless status is SNOOZED.

RelationshipSignal.status · RelationshipSignalStatus! non-null enum

Where the signal stands with the workspace.

RelationshipSignal.whatChanged · String! non-null scalar

What changed, in a sentence.

RelationshipSignal.whyItMatters · String! non-null scalar

Why the change matters to this workspace, in a sentence.

Member Of

DismissRelationshipSignalPayload object · MarkRelationshipSignalActedOnPayload object · RelationshipSignalEdge object · SnoozeRelationshipSignalPayload object