Evaluation

Evaluations represent the assessment of pitches.

📄️ Add Evaluation

Requests a new pending evaluation for a user. Omit `userId` to create one for the authenticated user. A user can have only one pending evaluation: requesting your own returns the existing pending evaluation, while requesting one for another user who already has one fails. The user must belong to a team. Requires the `evaluation:add` permission for the user.

📄️ Get Evaluation

Retrieves a single evaluation by its ID, including its state, categories, and recording URLs. Requires the `evaluation:list` permission for the evaluated user or the evaluator. Use `/evaluation/list` instead to find evaluations for a user.

📄️ List Evaluations

Lists evaluations relevant to a user: evaluations of the user, evaluations assigned to the user as evaluator, and evaluations for teams the user directly manages. Omit `userId` to use the authenticated user. Archived evaluations are excluded. Requires the `evaluation:list` permission for the user. Returns summary records; use `/evaluation/get` for full details.

📄️ Remove Evaluation

Removes an evaluation by its ID. By default the evaluation is archived; set `archive` to `false` to delete it permanently. Requires the `evaluation:delete` permission for the evaluated user or the evaluator.

📄️ Update Evaluation

Updates an evaluation, for example to change its state, evaluator, or categories. Send the complete evaluation object (as returned by `/evaluation/get`) with your changes, because it replaces the stored evaluation. Requires the `evaluation:add` permission for the evaluated user or the evaluator.

📄️ Evaluation Webhooks

This webhook is triggered when an action is taken on an evaluation.