List File Sharing Sessions

Retrieves a list of all file sharing sessions.

Responses

🟢200Success

application/json

Body

array of:

string

required

title

string

required

Title of the sharing session.

recipients

array[object (Recipient) {7}]

required

Users who files will be shared with.

string

optional

Email of the recipient. Required if phoneNum not set.

firstName

string

optional

First name of the recipient.

lastName

string

optional

First name of the recipient.

phone

string

optional

Phone number (mobile) of the recipient. Required if email not set.

authMethod

object (AuthenticationMethod)

optional

Method used to authenticate recipient

sendMethod

enum<string>

optional

How recipient will receive request notifications. Defaults to e-mail.

Allowed values:

DEFAULTEMAILSMSBOTHMULTIPLE

completionOrder

number

optional

Order that recipient must complete request in. Must be positive integer and must form complete, sequential list with remaining recipients.

expirationDate

string <date-time>

optional

Timestamp when the file sharing session will expire and no longer be available for access and/or download.

deletionDate

string <date-time>

optional

Timestamp when all files will be automatically deleted from Pigeon.

customMessage

string

optional

Custom message to be displayed when recipients are viewing the file sharing session.

sendMethod

enum<string>

required

How recipients will receive file sharing notifications. Defaults to e-mail.

Allowed values:

DEFAULTEMAILSMSBOTHMULTIPLE

language

enum<string>

required

Allowed values:

en-USesarzhfrdehtheiditkoptparu

files

array[object (SharingFiles) {3}]

required

Files associated with file sharing session.

string

required

name

string

required

File name

mime

string

required

File MIME type

Example

[
  {
    "id": "886a471d-0853-47c1-9d5d-8b994b870f52",
    "title": "considero defungo venia",
    "recipients": [
      {
        "email": "Elroy61@hotmail.com",
        "firstName": "Dave",
        "lastName": "Stehr",
        "phoneNum": "1-502-446-5836 x4461",
        "authMethod": {
          "type": "EMAIL_ACCESS_CODE",
          "questionText": "adipisicing est Excepteur mollit officia",
          "questionAnswer": "ad enim nisi"
        }
      },
      {
        "email": "Chadrick81@gmail.com",
        "firstName": "Darryl",
        "lastName": "Fay",
        "phoneNum": "(394) 548-9456 x86182",
        "authMethod": {
          "type": "EMAIL_ACCESS_CODE",
          "questionText": "Duis",
          "questionAnswer": "proident eiusmod consequat aute"
        }
      },
      {
        "email": "Melody.Bruen13@hotmail.com",
        "firstName": "Berneice",
        "lastName": "Howell",
        "phoneNum": "1-747-650-5915 x92577",
        "authMethod": {
          "type": "SMS_ACCESS_CODE",
          "questionText": "Excepteur ipsum nostrud",
          "questionAnswer": "mollit"
        }
      }
    ],
    "expirationDate": "2024-10-03T10:08:40.14Z",
    "deletionDate": "2024-10-03T10:08:40.141Z",
    "customMessage": "Adstringo bos dignissimos ab. Campana clementia cum bos stillicidium approbo. Altus supellex delinquo bellum similique.",
    "sendMethod": "EMAIL_AND_SMS",
    "language": "es",
    "files": [
      {
        "id": "eiusmod veniam ullamco cillum",
        "name": "vester vomito suffoco",
        "mime": "application/pdf"
      },
      {
        "id": "minim aliqua elit dolore",
        "name": "usus complectus acquiro",
        "mime": "application/pdf"
      },
      {
        "id": "Duis occaecat ut",
        "name": "thymum apto usitas",
        "mime": "application/pdf"
      }
    ]
  }
]

List File Sharing Sessions

Request

Request samples

Responses