Create a parent collection Document in document-service

post/api/evs/api/document-service/internal/v1/documents

EVS invokes this after AI prescreening identifies documents the applicant still needs to provide — doc-service persists a single parent Document bound to the Persona case via externalReferenceId, and the returned documentId is stored on persona_case.document_service_document_id so the UI can later call GET /documents/:documentId for the manifest.

Request Body

documentType string required
Discriminator for the "case required documents" collection. Emitted by EVS's AI prescreening workflow when the model identifies documents the applicant still needs to provide — doc-service then groups them under a single parent Document scoped to the Persona case.
Allowed value: caseRequiredDocuments
externalReferenceId string required
Min length: >= 1 characters
files array[object] required
Shape of each file entry in the collection. `documentType` is typed loosely as `t.string` rather than the strict `DocumentType` keyof codec from `./documentType` because the OpenAPI generator cannot statically resolve `DOCUMENT_TYPE_VALUES` across package boundaries (it lives in `@bitgo-private/document-service-types`). The receiving endpoint (doc-service, ON-6103) validates the value against its own canonical list, and the EVS caller constructs the list via the strict runtime `RequiredDocument` codec, so strictness is preserved at both ends of the wire even though the api-ts contract itself is permissive.
documentType string required
label string required
reason string
userId string
Min length: >= 1 characters

201 Response

documentId string required
Min length: >= 1 characters

400 Response

name string
context object required
status number
additionalDetails object
retryAfter number required
error string required
requestId string required

404 Response

name string
context object required
status number
additionalDetails object
retryAfter number required
error string required
requestId string required

500 Response

name string
context object required
status number
additionalDetails object
retryAfter number required
error string required
requestId string required