# Kith Sourcing API reference (/sourcing/reference)

These pages are generated from the API's [schema](/schemas/sourcing.graphql), and say what the schema itself says. The API is being built domain by domain: they list what exists today.

## Queries [#queries]

- [`searches`](/sourcing/reference/queries/searches): The workspace's searches, by latest message, newest first. A member's first visit to an empty workspace adds three example searches.
- [`viewer`](/sourcing/reference/queries/viewer): Who is making this request, and the workspace they act in.

## Objects [#objects]

- [`PageInfo`](/sourcing/reference/objects/page-info): Where a page of a list starts and ends, and whether more follows.
- [`Search`](/sourcing/reference/objects/search): 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.
- [`SearchClient`](/sourcing/reference/objects/search-client): The client a search is for.
- [`SearchConnection`](/sourcing/reference/objects/search-connection): A page of searches.
- [`SearchEdge`](/sourcing/reference/objects/search-edge): One search, with its cursor.
- [`SearchOrigin`](/sourcing/reference/objects/search-origin): The site a search was opened from, when it was not opened in Kith itself.
- [`Viewer`](/sourcing/reference/objects/viewer): Who is making this request.
- [`Workspace`](/sourcing/reference/objects/workspace): A workspace: one team's searches, candidates and settings. Every record belongs to exactly one.

## Enums [#enums]

- [`SearchAllowance`](/sourcing/reference/enums/search-allowance): Whether a workspace can start sourcing now.
- [`SearchArchive`](/sourcing/reference/enums/search-archive): Which searches to list, by whether the workspace has archived them.
- [`SearchClientSource`](/sourcing/reference/enums/search-client-source): How a search's client was chosen.
- [`SearchDepth`](/sourcing/reference/enums/search-depth): How deep a search goes: how many people Kith looks for, and how carefully it checks each.
- [`SearchStatus`](/sourcing/reference/enums/search-status): Where a search stands.

## Scalars [#scalars]

- [`Boolean`](/sourcing/reference/scalars/boolean): The `Boolean` scalar type represents `true` or `false`.
- [`DateTime`](/sourcing/reference/scalars/date-time): A moment in time, as an ISO 8601 string in UTC, such as `2026-11-16T09:30:00.000Z`.
- [`ID`](/sourcing/reference/scalars/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`](/sourcing/reference/scalars/int): The `Int` scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.
- [`String`](/sourcing/reference/scalars/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.