Skip to main content
POST
Create a fit criterion

Authorizations

Authorization
string
header
required

Your secret key (pep_sk_…) from Settings → API. Keys are org-scoped; treat them like passwords.

Body

application/json
kind
enum<string>
Available options:
ideal,
acceptable,
poor_fit,
dealbreaker
description
string
guidance
string | null

How the agent should judge this criterion.

weight
enum<integer> | null
Available options:
1,
2,
3,
null
agents
string[]

Which agents judge by this criterion. Absent on create = all current agents.

Response

The created criterion.

object
string
required
Allowed value: "fit_criterion"
id
integer
required
kind
enum<string>
required
Available options:
ideal,
acceptable,
poor_fit,
dealbreaker
description
string
required
agents
string[]
required
created_at
string<date-time>
required
guidance
string | null
weight
integer | null
archived
boolean