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

Kith ATS API reference

Every query, object, input, enum and scalar of the Kith ATS API, generated from its schema.

These pages are generated from the API's schema, and say what the schema itself says. The API is being built domain by domain: they list what exists today.

Queries

  • candidate: One candidate by id, or null when the workspace has no such candidate.
  • candidates: The workspace's candidates, oldest first. Candidates still in Kith ATS's own sourcing review are not included.
  • job: One job by id, or null when the workspace has no such job.
  • jobCandidate: One candidate's place on a job, by that place's id, or null when the workspace has none with it.
  • jobs: The workspace's jobs, oldest first.
  • viewer: Who is making this request. Use it to check which workspace a key belongs to before writing.

Objects

  • Candidate: A person a workspace knows as a possible hire. They are in the workspace's records whether or not they are on a job: see jobs for the jobs they are on.
  • CandidateConnection: A page of candidates.
  • CandidateEdge: One candidate, with its cursor.
  • Job: A role a workspace is hiring for, with its brief. Candidates are worked against a job one by one: see candidates.
  • JobCandidate: A candidate's place on one job: their stage in its pipeline, how well they fit, and the recruiter's decision. A candidate has one of these for each job they are on.
  • JobCandidateConnection: A page of candidates' places on jobs.
  • JobCandidateEdge: One place on a job, with its cursor.
  • JobCandidateSignal: One piece of evidence about how a candidate fits a job, as shown beside their grade.
  • JobCandidateSummaryPoint: One line of the written summary of a candidate for a job.
  • JobConnection: A page of jobs.
  • JobEdge: One job, with its cursor.
  • PageInfo: Where a page of a list starts and ends, and whether more follows.
  • Viewer: Who is making this request.
  • Workspace: A workspace: one recruiting team's jobs, candidates and settings. Every record belongs to exactly one.

Inputs

  • CandidateFilter: Which candidates to list. Every condition given must hold.
  • JobCandidateFilter: Which candidates on a job to list. Every condition given must hold.
  • JobFilter: Which jobs to list. Every condition given must hold.

Enums

Scalars

  • Boolean: The Boolean scalar type represents true or false.
  • DateTime: A moment in time, as an ISO 8601 string in UTC, such as 2026-11-16T09:30:00.000Z.
  • ID: The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.
  • Int: The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
  • String: The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

On this page