evidence_create
Register a new evidence record into an evidence group. Choose internal custody to upload a file or external to register only the hash.
Instructions
Registers a NEW evidence record inside an evidence group. Requires: evidence_group_create → evidenceGroupId, case_file_create → caseFileId. Generate a UUID v4 for id. Compute the SHA-256 hex hash of the file BEFORE calling. Normal INTERNAL flow: call evidence_create with custodyType INTERNAL and NO fileUrl; the API returns uploadFileUrl, a presigned S3 URL. You MUST PUT the exact file bytes to uploadFileUrl, then verify with evidence_get/evidence_list, and ONLY THEN call evidence_seal. Do not seal an evidence group until every INTERNAL evidence file has been uploaded. Convenience flow: if you pass fileUrl (public HTTPS, no redirects, under 1 GiB), this tool downloads that URL and PUTs the bytes to uploadFileUrl for you. EXTERNAL flow: use custodyType EXTERNAL only when you intentionally register hash-only evidence; still generate a fresh UUID for each evidence. If an INTERNAL evidence creation/upload failed and you want to retry as EXTERNAL, create a NEW evidence id; do not reuse an id whose outcome is unknown. WARNING: the API sometimes returns {code:'EvidenceCreateError'} even when the evidence was successfully persisted — always verify with evidence_list before retrying.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | UUID v4 for the new evidence record (idempotency key) | |
| hash | Yes | SHA-256 hex digest of the file content (64 hex chars) | |
| title | Yes | Human-readable title for the evidence | |
| fileUrl | No | Optional public HTTPS URL to download and auto-upload to the returned uploadFileUrl (custodyType INTERNAL only). Omit this when you want the manual presigned-URL flow. | |
| fileName | Yes | Original file name including extension | |
| caseFileId | Yes | UUID of the case file | |
| custodyType | No | INTERNAL = EAD stores the file; EXTERNAL = only hash registered | INTERNAL |
| evidenceGroupId | Yes | UUID of the evidence group |