evidence

Post Evidence

Post one evidence event into the evidence ledger (protocol v0.2 V9a, POST /evidence): an actor did an action to an object at a point in time, optionally with a location and provenance. idempotency_key is required — the same (org, idempotency_key) always returns the same row, never a second insert. Optionally correlate the event to a task or task list. Write tier; a device credential (structurally different from an API key) is not reachable through this MCP connection, so device_id is never set here.

post/evidence

Request

  • Base URL: https://app.tascan.io/api/v1
  • URL: https://app.tascan.io/api/v1/evidence
  • Auth: HTTP bearer

Request body

actionstring required

What happened, e.g. inspected, scanned, calibrated.

occurred_atstring required

ISO timestamp for when the event actually happened.

provenanceobject

Optional provenance object. provenance.kind first_party_scan is written only by the scan_events trigger and is refused from a caller; provenance.signature triggers device-signature verification.

idempotency_keystring required

Required, 1-200 chars. The same key on the same org replays the same stored row.

Response

Success. JSON body: { data: ... } or an error object { error, message }.

Changes

No recorded changes to this operation across all 1 revision of this API.