Skip to main content
The grader library is Egma’s catalog of judgment templates. Each entry defines a type of judgment — the prompt sent to the model, the output schema, and the form fields your team fills in when activating it. Entries maintained by Egma are available to every organization; your own organization’s custom entries appear alongside them once the authoring surface is available. Browse the library to discover what Egma ships, read the params field to understand what each entry expects you to fill in, and then create a grader from any entry you want to run against your project.

​
List grader library entries

Returns all library entries visible to your organization, ordered newest first. GET /api/grader-library
​
string
The prj_ identifier of the project context. Omit this to read the library across your whole organization.
​
string
Pagination cursor. Pass the next_cursor value from a previous response to fetch the next page. Omit to start from the first page.
​
array
Array of library entry objects. See the library entry object below.
​
string | null
Cursor for the next page. null means you have reached the last page.
List all library entries
Paginate through the library

​
The library entry object

​
string
The grl_ identifier for this library entry. Pass this as library_id when creating a grader.
​
string
Human-readable name of this grader template.
​
string
What this grader judges and why you would use it.
​
string
The kind of judgment this entry makes. All graders created from this entry share this type.
​
string
Either "egma" for built-in entries or "organization" for entries your team created.
​
string | null
The project this entry is scoped to, if it was authored for a specific project. null for organization-wide and Egma-maintained entries.
​
number
The current version of the library entry’s definition.
​
string
The judge prompt Egma sends to the model when evaluating a conversation. This is the exact text used at judgment time — what you read here is what the model receives.
​
array
The form fields your team fills in when creating a grader from this entry. Each element describes one field: its key, type, label, and any constraints. Pass the filled-in values as the params object when calling POST /api/graders.
​
object
The schema of the verdict this grader produces.
​
string
ISO 8601 timestamp of when this entry was created.
​
string
ISO 8601 timestamp of the last update to this entry’s definition.

​
Activating a library entry

To start judging conversations with a library entry, create a project grader from it. The library entry decides what kind of judgment is made and what parameters it accepts; your copy holds the values you chose.
Read the library entry first
Create a grader from the entry
The params object must match the shape described by the entry’s params array. Sending keys the entry does not define, or omitting required ones, returns 422 Unprocessable Content with a message explaining exactly what went wrong. Read the params field on the library entry before constructing your request.
Each library entry can have multiple active project copies — useful when you want to run the same grader with different thresholds, scopes, or required settings. Use the entry’s id as library_id in each POST /api/graders call.