copyAttachment
Copy an existing attachment onto the attachments of one or more records.
Business Rules
- The attachment must belong to the active company.
- Between 1 and 50 destinations per call.
- Every destination must belong to the active company and accept the attachment.
- Each copy is independent: a later change to the original attachment, or deleting it, does not reach the copy, and deleting the copy does not touch the original.
- A copy keeps the tag and description of the original as a starting point.
- A destination that already has an attachment with the same name and type is not copied.
- Repeating the request does not duplicate a copy a destination already has.
- Progress and per-destination outcomes are reported on the returned process.
Error Scenarios
- **
UNPROCESSABLE_CONTENT**: no destination was selected, more than 50 were, a destination was repeated, or the combination of entity types is not supported. - **
NOT_FOUND**: the attachment or a destination does not belong to the active company. - **
UNAUTHORIZED**: missing required permissions or invalid company access.
Permissions Required
global:copy_attachmentspermission
copyAttachment(
input: CopyAttachmentInput!
): AsynchronousActionResponse!
Arguments
copyAttachment.input ● CopyAttachmentInput! non-null input common
Parameters for CopyAttachment
Type
AsynchronousActionResponse object common
Asynchronous action response type