Skip to main content

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_attachments permission
copyAttachment(
input: CopyAttachmentInput!
): AsynchronousActionResponse!

Arguments​

copyAttachment.input ● CopyAttachmentInput! non-null input common​

Parameters for CopyAttachment

Type​

AsynchronousActionResponse object common​

Asynchronous action response type