The API is being built domain by domain. The reference shows what exists today.
Skip to Content
KITHDocs
ReferenceObjects

Job

A role a workspace is hiring for, with its brief. Candidates are worked against a job one by one: see candidates.

type Job {
  candidates(
    after: String
    before: String
    filter: JobCandidateFilter
    first: Int
    last: Int
  ): JobCandidateConnection!
  companyName: String
  companyWebsite: String
  createdAt: DateTime!
  description: String
  id: ID!
  location: String
  mustHaves: [String!]!
  niceToHaves: [String!]!
  redFlags: [String!]!
  salaryMax: Int
  salaryMin: Int
  searchStatus: JobSearchStatus
  status: JobStatus!
  title: String!
  updatedAt: DateTime!
}

Fields

Job.candidates · JobCandidateConnection! non-null object

The candidates on this job, each with their stage, grade and decision, in the order they were added. Candidates still in Kith ATS's own sourcing review are not included.

Job.candidates.after · String scalar

Return the rows that follow this cursor.

Job.candidates.before · String scalar

Return the rows that come before this cursor.

Job.candidates.filter · JobCandidateFilter input

Narrow the list. Left out, every candidate on the job is returned.

Job.candidates.first · Int scalar

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

Job.candidates.last · Int scalar

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

Job.companyName · String scalar

The hiring company, as the brief names it.

Job.companyWebsite · String scalar

The hiring company's website, as https:// and its public domain.

Job.createdAt · DateTime! non-null scalar

When the job was created.

Job.description · String scalar

The role, described in prose. May be long.

Job.id · ID! non-null scalar

The job's id, as in its URL in the app.

Job.location · String scalar

Where the role is based, as the brief says it: a city, a region, "Remote".

Job.mustHaves · [String!]! non-null scalar

What a candidate must have to be considered, one requirement per entry.

Job.niceToHaves · [String!]! non-null scalar

What counts in a candidate's favour without being required.

Job.redFlags · [String!]! non-null scalar

What rules a candidate out, or counts against them.

Job.salaryMax · Int scalar

The top of the base salary range, in whole units of the role's currency.

Job.salaryMin · Int scalar

The bottom of the base salary range, in whole units of the role's currency.

Job.searchStatus · JobSearchStatus enum

How far the search has got, when the team tracks it. Null when it does not.

Job.status · JobStatus! non-null enum

Whether the job is being worked.

Job.title · String! non-null scalar

The role's title, such as "Founding Account Executive".

Job.updatedAt · DateTime! non-null scalar

When the job itself last changed.

Returned By

job query

Member Of

JobCandidate object · JobEdge object

On this page