Get File Sharing Session

Request

Path Params

id

string

required

ID

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

Responses

🟢200Success

application/json

Body

id

string

required

ID

title

string

required

Title of the sharing session.

recipients

array[object (Recipient) {7}]

required

Users who files will be shared with.

email

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.

id

string

required

ID

name

string

required

File name

mime

string

required

File MIME type

Example

{
    "id": "b1e90dbc-ed93-4178-9752-0b506322b6b7",
    "title": "aureus bene versus",
    "recipients": [
        {
            "email": "Gabrielle47@yahoo.com",
            "firstName": "Percy",
            "lastName": "Predovic",
            "phoneNum": "937-674-3195 x20155",
            "authMethod": {
                "type": "SMS_ACCESS_CODE",
                "questionText": "sunt",
                "questionAnswer": "ut ipsum ad consectetur"
            }
        }
    ],
    "expirationDate": "2024-10-03T10:09:38.843Z",
    "deletionDate": "2024-10-03T10:09:38.843Z",
    "customMessage": "Tersus adulatio ulterius curriculum succedo libero attero solutio. Eos apto tonsor cicuta adficio clementia audax adimpleo casso incidunt. Sophismata apud aestus blandior vacuus.",
    "sendMethod": "EMAIL_AND_SMS",
    "language": "en",
    "files": [
        {
            "id": "esse",
            "name": "deserunt avaritia culpa",
            "mime": "application/pdf"
        }
    ]
}

🟠404Record Not Found