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:
- Job summary card: A job at a glance.
- Job brief: A versioned brief with must-haves, nice-to-haves and red flags.