/icws/{sessionId}/interactions/{interactionId}/email/attachments/message/download

Feature Version
interactions 10

POST

/icws/{sessionId}/interactions/{interactionId}/email/attachments/message/download

Gets the message attachment and any nested message attachments.
Feature Version
interactions 10

Request

Parameters
Type
Name
Comments
Header
ININ-ICWS-CSRF-Token

Required

The ININ session token necessary for all calls that require a security or user context.

    Header
    Cookie

    Required

    The session cookie. With the exception of the connection request, all requests must provide a session cookie.

      Template
      sessionId

      Required

      The ININ session ID necessary for all calls that require a security or user context.

        Template
        interactionId

        Required

        The interaction ID for the interaction resource.

          Representations
          emailGetMessageParameters
          Property
          Value
          Comments
          messageId
          String

          Required

          The messageId of the message to retrieve.

          Response

          202 - Accepted
          The attached message and any nested attached messages are being assembled.
          asyncOperationAcceptedResponse
          Represents the successful initiation of an asynchronous operation.
          Property
          Value
          Comments
          requestId
          String

          Required

          The ID associated with the asynchronous operation request. This can be used to correlate future events and operations.
          Associated Message
          The requested attached message content along with any nested attached messages content.
          emailMessageAttachmentMessage
          Property
          Value
          Comments
          __type
          "urn:inin.com:interactions.email:emailMessageAttachmentMessage"

          Required

          The JSON type representing this option.
          isDelta
          Boolean

          Required

          When true, this property indicates that some optional properties that have not changed may be omitted (all required properties will be included). In this case, the client side cache should be updated with the values for the properties provided and no change should be made for the properties not included as part of the message. This allows the API to deliver smaller messages that only represent the properties that have changed.

          When this property is false, the client side cache for this subscription should be cleared and replaced with the data provided in the message. For the initial message in response to a subscription, this property will be false to indicate the cache should be initialized with the data provided.

          requestId
          String

          Required

          errorId
          String
          The error identifier that describes the current error.
          message
          String

          Required

          A message that describes the current error.
          interactionId
          String

          Required

          The ID of the interaction this message corresponds to.
          __type
          "urn:inin.com:interactions.email:emailMessageContentsResponse"

          Required

          The JSON type representing this option.
          subject
          String

          Required

          The subject of the email.
          displayName
          String

          Required

          The display name for the email address.
          address
          String
          The email address.
          body
          String

          Required

          An email body.
          Text
          0
          Html
          1
          receivedTimestamp
          DateTime

          Required

          The timestamp of when the email was received.
          OK
          0
          The email signature was validated.
          MessageModified
          1
          The message was modified after it was signed.
          CertificateNotTrusted
          2
          The email signature is not considered trusted.
          EmailHeaderMismatch
          4
          The email sender does not match the email signature.
          Unknown
          128
          The email signature could not be validated for an unknown reason.
          version
          Int

          Required

          The version of the certificate.
          serialNumber
          String

          Required

          The serial number of the certificate.
          signatureAlgorithm
          String

          Required

          The algorithm used for the signature of the certificate.
          issuer
          String

          Required

          The issuer of the certificate.
          validFrom
          DateTime

          Required

          The start of the period for which the certificate is valid.
          validTo
          DateTime

          Required

          The end of the period for which the certificate is valid.
          subject
          String

          Required

          The subject of the certificate.
          __type
          "urn:inin.com:interactions.email:emailFileAttachment"

          Required

          The JSON type representing this option.
          name
          String

          Required

          The name of the file.
          contentId
          String

          Required

          The Content-ID of the file, which conforms to RFC 2111.
          downloadUri
          Uri

          Required

          The location where the file can be downloaded.

          By default, when GETing the file, ICWS will respond with the 'Content-Type' header set to the proper content type of the file.

          When making a request from a web browser, it may be desirable to force the file to be downloaded. In this case the query string '?action=download' should be added to the end of a file's downloadUri. This will force the response header 'Content-Type' to be set to 'application/octet-stream' and will add the header 'Content-Disposition' set to 'attachment'.

          messageAttachments
          List [1,*]: Complex Type: emailMessageContentsResponse

          Recursive

          The email's message attachments. Note: These will be the actual attached messages instead of just the subject and associated retrieval messageId as they are with an emailContentsResponse.
          400 - Bad Request
          The request was invalid. This can occur when the interaction or cookie is not recognized, or if the interaction is not an email interaction. This will also occur if a required header or query string parameter is missing or invalid.
          error
          Provides additional detail for an error.
          Property
          Value
          Comments
          errorId
          String
          The error identifier that describes the current error.
          message
          String

          Required

          A message that describes the current error.
          404 - Not Found
          The interaction does not exist.
          error
          Provides additional detail for an error.
          Property
          Value
          Comments
          errorId
          String
          The error identifier that describes the current error.
          message
          String

          Required

          A message that describes the current error.
          403 - Forbidden
          You do not have rights to the interaction.
          error
          Provides additional detail for an error.
          Property
          Value
          Comments
          errorId
          String
          The error identifier that describes the current error.
          message
          String

          Required

          A message that describes the current error.
          401 - Unauthorized
          The specified session token is missing, invalid, or has expired.
          Parameters
          Type
          Name
          Comments
          Header
          WWW-Authenticate

          Required

          Indicates that the client needs to authenticate using a custom ICWS scheme, which supports a realm of type ICWS and a location which is the URL at which the client can authenticate. A typical example would be the following.

          WWW-Authenticate: ICWS realm="ICWS" location="/ICWS/connection"

            error
            Provides additional detail for an error.
            Property
            Value
            Comments
            errorId
            String
            The error identifier that describes the current error.
            message
            String

            Required

            A message that describes the current error.
            410 - Gone
            This resource has been deprecated and removed from the API.
            error
            Provides additional detail for an error.
            Property
            Value
            Comments
            errorId
            String
            The error identifier that describes the current error.
            message
            String

            Required

            A message that describes the current error.
            500 - Internal Server Error
            An unexpected error occurred while processing the request.
            error
            Provides additional detail for an error.
            Property
            Value
            Comments
            errorId
            String
            The error identifier that describes the current error.
            message
            String

            Required

            A message that describes the current error.