Social checklist

Record evidence on a Social checklist observation item

Record what an assistant found for one of the observation items whose done-when is a recorded finding (agent.can_record_evidence is true). The mark is stored as an assistant's (status_source agent, naming this key and no person) and is never written over a person's mark or one SAGARIS detected itself (409 person_mark, detected_mark). Any other item answers 409 approval_required: submit its output instead. Nothing live changes. Requires the social_checklist.record scope.

post/social/checklist/items/{id}/evidence

Request

  • Base URL: https://www.sagaris.ai/api/v1
  • URL: https://www.sagaris.ai/api/v1/social/checklist/items/{id}/evidence
  • Auth: HTTP bearer

Path parameters

idstring required

A Social checklist item id from the catalog, such as OT-02 (one-time) or ON-46 (ongoing).

Headers

Idempotency-Keystring

Opaque client-supplied key. A retry with the same key replays the original response instead of writing again.

Request body

status'done' | 'in_progress' required

done when the finding is complete; in_progress when part of it is.

evidencestring required

What was found, with a link where there is one.

done_onstring date

status done only: the calendar day it was done (YYYY-MM-DD). Defaults to today.

Response

An existing assistant's mark was updated.

errorunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.