""" A moment in time, as an ISO 8601 string in UTC, such as `2026-11-16T09:30:00.000Z`. """ scalar DateTime """Where a page of a list starts and ends, and whether more follows.""" type PageInfo { """ The cursor of the page's last row, or null for an empty page. Pass it as `after` for the next page. """ endCursor: String """True when rows follow this page.""" hasNextPage: Boolean! """True when rows come before this page.""" hasPreviousPage: Boolean! """The cursor of the page's first row, or null for an empty page.""" startCursor: String } """Everything that can be read.""" type Query { """ The workspace's searches, by latest message, newest first. A member's first visit to an empty workspace adds three example searches. """ searches( """Return the rows that follow this cursor.""" after: String """Which searches to list, by whether they are archived.""" archive: SearchArchive = ACTIVE """Return the rows that come before this cursor.""" before: String """ How many rows to return, from the start or from `after`. 50 when left out, 200 at most. """ first: Int """ How many rows to return, counting back from the end or from `before`. 200 at most. """ last: Int """ Only searches whose title, company, location or messages contain this text, in any case. 200 characters at most. """ query: String ): SearchConnection! """Who is making this request, and the workspace they act in.""" viewer: Viewer! } """ A search: one conversation with Kith about one role, holding its brief, the people Kith found and the decisions on them. A search belongs to the whole workspace. """ type Search { """ Increases each time the search is archived or restored, so a caller holding two answers can tell which is newer. """ archiveVersion: Int! """ When the workspace archived the search. Null for one it has not. Archiving hides a search from everyday lists and changes nothing else about it. """ archivedAt: DateTime """ The number of the brief's current revision. 0 until Kith has read the brief. """ briefRevision: Int! """How many people Kith has delivered in the search so far.""" candidateCount: Int! """The client the search is for, when one is set.""" client: SearchClient """The hiring company, as the brief names it.""" company: String! """How deep the search goes.""" depth: SearchDepth """The search's id, as in its URL in the app.""" id: ID! """The text of the latest message in the search.""" lastMessage: String! """ When the latest message was sent. Searches are listed by it, newest first. """ lastMessageAt: DateTime """Where the role is based, as the brief says it.""" location: String! """The site the search was opened from. Null for a search opened in Kith.""" origin: SearchOrigin """ How many people in the search's delivered shortlists the caller has not seen yet. Counted for each member separately. """ peopleToReview: Int! """ Orders the caller's own marks of what they have seen: the latest mark `peopleToReview` takes in. A count with a lower version was read before a later mark. 0 before any mark. """ seenVersion: Int! """Where the search stands.""" status: SearchStatus! """ The search's name: the role and company once Kith has read the brief, a working title before. """ title: String! """When anything about the search last changed.""" updatedAt: DateTime! } """Whether a workspace can start sourcing now.""" enum SearchAllowance { """ Searches can be started, and the workspace is close to its current allowance. """ APPROACHING """Searches can be started.""" AVAILABLE """ Searches cannot start sourcing for now. A search opened meanwhile starts once they can. """ UNAVAILABLE } """Which searches to list, by whether the workspace has archived them.""" enum SearchArchive { """Searches the workspace has not archived.""" ACTIVE """Both.""" ALL """Searches the workspace has archived.""" ARCHIVED } """The client a search is for.""" type SearchClient { """The client's id.""" id: ID! """The client's name.""" name: String! """How the client was chosen for this search.""" source: SearchClientSource } """How a search's client was chosen.""" enum SearchClientSource { """The applicant tracking system that opened the search set it.""" ATS """Kith took it from the brief's hiring company.""" BRIEF """A member picked it by hand.""" USER } """A page of searches.""" type SearchConnection { """The rows of this page, each with its cursor.""" edges: [SearchEdge!]! """Whether there is more to read, and from where.""" pageInfo: PageInfo! } """ How deep a search goes: how many people Kith looks for, and how carefully it checks each. """ enum SearchDepth { """Everyone Kith can find.""" EXHAUSTIVE """ The strongest matches, fast. Anyone Kith cannot check cheaply is skipped. """ QUICK """ Everyone likely to fit, with close matches flagged rather than dropped. The default. """ THOROUGH } """One search, with its cursor.""" type SearchEdge { """ Where this row sits in the list. Pass it as `after` to read on from here. """ cursor: String! """The row.""" node: Search! } """ The site a search was opened from, when it was not opened in Kith itself. """ type SearchOrigin { """The site's name.""" name: String! } """Where a search stands.""" enum SearchStatus { """Finished.""" COMPLETE """ Its brief is not ready: it still needs a role, a location or a must-have. Kith has asked for what is missing. """ DRAFT """Put on hold. Nothing is sourced until it is resumed.""" PAUSED """A shortlist has been delivered and is waiting for decisions.""" REVIEW """Kith is finding people.""" SOURCING } """Who is making this request.""" type Viewer { """ The workspace the request acts in. Everything this API returns belongs to it. """ workspace: Workspace! } """ A workspace: one team's searches, candidates and settings. Every record belongs to exactly one. """ type Workspace { """The depth a new search takes unless it names another.""" defaultSearchDepth: SearchDepth! """Whether the workspace can start sourcing now.""" searchAllowance: SearchAllowance! }