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

Job

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

type Job {
  auditTrail(
    after: String
    filter: AuditFilter
    first: Int
  ): AuditEntryConnection!
  briefRevision: Int!
  candidates(
    after: String
    before: String
    filter: JobCandidateFilter
    first: Int
    last: Int
  ): JobCandidateConnection!
  client: Company
  companyName: String
  companyWebsite: String
  createdAt: DateTime!
  description: String
  documents(
    after: String
    before: String
    first: Int
    last: Int
  ): JobDocumentConnection!
  expectedFee: Decimal
  id: ID!
  location: String
  mustHaves: [String!]!
  niceToHaves: [String!]!
  opportunity: Opportunity
  pipelineSummary: JobPipelineSummary
  recruitingTasks(
    after: String
    before: String
    filter: RecruitingTaskFilter
    first: Int
    last: Int
  ): RecruitingTaskConnection!
  redFlags: [String!]!
  salaryMax: Int
  salaryMin: Int
  searchStatus: JobSearchStatus
  status: JobStatus!
  title: String!
  updatedAt: DateTime!
}

Fields

Job.auditTrail · AuditEntryConnection! non-null object

Everything that has happened to people on this job: stage moves and decisions, notes and agents' runs, newest first. The filter is applied to the whole trail before it is paged. Entries about people, or places on the job, not yet released to the workspace are left out. This list pages forward only.

Job.auditTrail.after · String scalar

Return the entries that follow this cursor.

Job.auditTrail.filter · AuditFilter input

Narrow the list. Left out, every entry is listed.

Job.auditTrail.first · Int scalar

How many entries to return. 50 when left out, 200 at most.

Job.briefRevision · Int! non-null scalar

The number of the brief's current revision. It starts at 1 and grows by one with every change to the brief, whoever made it. Send it as baseRevision when you edit the brief, and compare it with an earlier read to know whether the brief has changed. 0 for a job whose brief has no recorded history yet.

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.client · Company object

The client company this job is for, once the job is linked to a company in the workspace's records. Null until then: companyName is only what the brief calls the company.

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.documents · JobDocumentConnection! non-null object

The documents uploaded to the job, in the order they were uploaded. Ask for last to read the newest.

Job.documents.after · String scalar

Return the rows that follow this cursor.

Job.documents.before · String scalar

Return the rows that come before this cursor.

Job.documents.first · Int scalar

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

Job.documents.last · Int scalar

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

Job.expectedFee · Decimal scalar

The fee the job is expected to bring, in its opportunity's currency. Under an opportunity whose fee is a percentage of first-year base, the server works it out from the middle of the salary range; otherwise it is the figure last entered.

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.opportunity · Opportunity object

The opportunity the job is worked under: the agreement whose terms set its fee. Null for a job with none, which is usual before terms are agreed.

Job.pipelineSummary · JobPipelineSummary object

How many candidates are on the job at each stage, and when its pipeline last changed. Counts only candidates released to the workspace. Cheaper than reading candidates for the counts alone.

Job.recruitingTasks · RecruitingTaskConnection! non-null object

Tasks the recruiting team created on this job, in id order, including completed and dismissed work.

Job.recruitingTasks.after · String scalar

Return the rows that follow this cursor.

Job.recruitingTasks.before · String scalar

Return the rows that come before this cursor.

Job.recruitingTasks.filter · RecruitingTaskFilter input

Narrow the tasks on this job.

Job.recruitingTasks.first · Int scalar

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

Job.recruitingTasks.last · Int scalar

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

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

AuditEntry object · CallAction object · CallRoleMatch object · CandidateNote object · CreateExampleJobPayload object · CreateJobPayload object · JobCandidate object · JobEdge object · Presentation object · RecruitingTask object · RoleRecommendation object · SetJobOpportunityPayload object · SetJobStatusPayload object · Touch object

Shown in the UI

These components show it:

On this page

FieldsJob.auditTrail · AuditEntryConnection! non-null objectJob.auditTrail.after · String scalarJob.auditTrail.filter · AuditFilter inputJob.auditTrail.first · Int scalarJob.briefRevision · Int! non-null scalarJob.candidates · JobCandidateConnection! non-null objectJob.candidates.after · String scalarJob.candidates.before · String scalarJob.candidates.filter · JobCandidateFilter inputJob.candidates.first · Int scalarJob.candidates.last · Int scalarJob.client · Company objectJob.companyName · String scalarJob.companyWebsite · String scalarJob.createdAt · DateTime! non-null scalarJob.description · String scalarJob.documents · JobDocumentConnection! non-null objectJob.documents.after · String scalarJob.documents.before · String scalarJob.documents.first · Int scalarJob.documents.last · Int scalarJob.expectedFee · Decimal scalarJob.id · ID! non-null scalarJob.location · String scalarJob.mustHaves · [String!]! non-null scalarJob.niceToHaves · [String!]! non-null scalarJob.opportunity · Opportunity objectJob.pipelineSummary · JobPipelineSummary objectJob.recruitingTasks · RecruitingTaskConnection! non-null objectJob.recruitingTasks.after · String scalarJob.recruitingTasks.before · String scalarJob.recruitingTasks.filter · RecruitingTaskFilter inputJob.recruitingTasks.first · Int scalarJob.recruitingTasks.last · Int scalarJob.redFlags · [String!]! non-null scalarJob.salaryMax · Int scalarJob.salaryMin · Int scalarJob.searchStatus · JobSearchStatus enumJob.status · JobStatus! non-null enumJob.title · String! non-null scalarJob.updatedAt · DateTime! non-null scalarReturned ByMember OfShown in the UI