evidence_group_evidence_register
Register a new evidence in an open evidence group to initiate the two-step upload process and obtain the upload URL for the file bytes.
Instructions
Register a new evidence in a group — the first step of a 2-step upload (register, then PUT the file bytes to the returned upload URL). Use for each file you want to add to an OPEN evidence group. Requires: evidence_group_create → evidenceGroupId, evidence_case_file_create → caseFileId, and the file's SHA-256 hash (compute it before calling, or use the evidence_create_sealed composite tool which does this for you). Do not call evidence_group_close until every registered evidence's bytes have been uploaded. Custody type: INTERNAL = EAD Factory stores and custodies the file itself. | EXTERNAL = The file lives outside EAD Factory — you attest to its hash only, EAD Factory never stores the bytes. Testimony (qualified proof) provider family: TSP = Trusted Service Provider — eIDAS-qualified electronic timestamp; the legally strongest proof tier. | DLT = Distributed Ledger Technology — blockchain-anchored proof; immutable and independently verifiable.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hash | Yes | ||
| type | No | ||
| title | No | ||
| fileName | No | ||
| fileSize | No | ||
| metadata | No | ||
| createdBy | No | ||
| testimony | Yes | ||
| capturedAt | Yes | ||
| caseFileId | Yes | MANDATORY. UUID of the parent case file. Obtain from evidence_case_file_create. | |
| evidenceId | Yes | MANDATORY. UUID of the evidence record. Obtain from evidence_group_evidence_register or generate_evidence. | |
| custodyType | Yes | ||
| deletionDate | No | ||
| deletionType | No | ||
| evidenceGroupId | Yes | MANDATORY. UUID of the evidence group. Obtain from evidence_group_create. | |
| requiredTestimonyProviders | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | ||
| expiration | No |