Attach a file to every copy of a record
POST/api/v1/anchor-groups/:anchorGroupId/shared-credentialing-workflows/:id/sections/:section/:credentialingDisplayGroupKey/attachments
Stores the file once and adds it to the attachments of every copy of the record held by a member workflow that is not locked, so the page shows one version for every tenant it reached. Locked workflows are skipped and reported; when every holder is locked, nothing is stored. Only the sections whose records carry attachments take one. Needs credentialing-workflow:details:create, details:update, details:delete and details:attachments:create on every member tenant. The file is checked as the tenant attachment upload checks it: PDF, JPG or PNG, within the size limit.
Request
Responses
- 201
- 400
- 403
- 404
- 409
- 415
- 422
Attached; the response's attachment names the stored file
INVALID_REQUEST: a section whose records carry no attachments, no file, a file that isn't PDF, JPG or PNG, an oversize file, a request part that isn't JSON, no expectedTenantIds, or an expirationDate that isn't YYYY-MM-DD
The permission is missing on a member tenant
No such shared workflow, or a member tenant the caller has no read on (all-tenant authority)
STALE_RECORD or WORKFLOW_CONFLICT; nothing was changed. Nothing is stored either, unless the conflict came after the file was stored (a retry that found the record changed, or retries that ran out): then the stored file is kept, referenced by no row
Not multipart/form-data
ALL_TENANTS_LOCKED: every workflow holding the record is at PSV Complete or later, so nothing was attached. Nothing is stored, unless they locked while the file was being saved: then the stored file is kept, referenced by no row