Skip to main content

Secure Share API Reference

Beta

Run In Postman

Base URL​

share.<csp>.<region>.pangea.cloud

post/v1beta/delete
curl -sSLX POST 'https://share.aws.us.pangea.cloud/v1beta/delete' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response

v-1-beta-delete

POST
https://share.aws.us.pangea.cloud/v1beta/delete

Delete an item from the Secure Share by providing its id or path.

Provide just id OR just path.

The force parameter can be used to delete folders and their contents even if the folder is not empty.

fields

string

The ID of the object to delete.

  • minLength: 36
boolean

If true, delete a folder even if it's not empty. Deletes the contents of folder as well.

string

The path of the object to delete.

  • minLength: 1

  • maxLength: 256

object

Pangea standard response schema

object
integer

Number of objects deleted.

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"
string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"
string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"
string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"
string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

post/v1beta/folder/create
curl -sSLX POST 'https://share.aws.us.pangea.cloud/v1beta/folder/create' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response

v-1-beta-folder-create

POST
https://share.aws.us.pangea.cloud/v1beta/folder/create

Create a Secure Share folder.

Use either parent_id with name to specify the folder to be created, or use path only to specify the complete path to the folder to be created.

fields

string

The name of an object.

object

A set of string-based key/value pairs used to provide additional data about an object.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

string

The ID of a stored object.

  • minLength: 36
string

An case-sensitive path to an object. Contains a sequence of path segments delimited by the the / character. Any path ending in a / character refers to a folder.

  • minLength: 1

  • maxLength: 256

array<string>

A list of user-defined tags

object

Pangea standard response schema

object

Information on the created folder.

object
integer

The number of billable bytes (includes Metadata, Tags, etc.) for the object.

string (date-time)

The date and time the object was created.

string

The ID of a stored object.

  • minLength: 36
string

The MD5 hash of the file contents. Cannot be written to.

object

A set of string-based key/value pairs used to provide additional data about an object.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

object

Protected (read-only) metadata.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

string

The SHA256 hash of the file contents. Cannot be written to.

string

The SHA512 hash of the file contents. Cannot be written to.

integer

The size of the object in bytes.

array<string>

A list of user-defined tags

array<string>

Protected (read-only) flags.

string

The type of the item (file or dir). Cannot be written to.

string (date-time)

The date and time the object was last updated.

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"
string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"
string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"
string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"
string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

post/v1beta/get
curl -sSLX POST 'https://share.aws.us.pangea.cloud/v1beta/get' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response

v-1-beta-get

POST
https://share.aws.us.pangea.cloud/v1beta/get

Download a file with from Secure Share by id OR path.

You can use the path parameter alone to specify the full path to the file, OR you can use the id of the file to be downloaded.

See Transfer Methods for information on transfer_method.

fields

string

The ID of the object to retrieve.

  • minLength: 36
string

The path of the object to retrieve.

  • minLength: 1

  • maxLength: 256

string

If the file was protected with a password, the password to decrypt with.

string

The requested transfer method for the file data.

object

Pangea standard response schema

object

File information.

string

A URL where the file can be downloaded from. (transfer_method: dest-url)

object
integer

The number of billable bytes (includes Metadata, Tags, etc.) for the object.

string (date-time)

The date and time the object was created.

string

The ID of a stored object.

  • minLength: 36
string

The MD5 hash of the file contents. Cannot be written to.

object

A set of string-based key/value pairs used to provide additional data about an object.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

object

Protected (read-only) metadata.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

string

The SHA256 hash of the file contents. Cannot be written to.

string

The SHA512 hash of the file contents. Cannot be written to.

integer

The size of the object in bytes.

array<string>

A list of user-defined tags

array<string>

Protected (read-only) flags.

string

The type of the item (file or dir). Cannot be written to.

string (date-time)

The date and time the object was last updated.

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"
string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"
string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"
string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"
string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

post/v1beta/get_archive
curl -sSLX POST 'https://share.aws.us.pangea.cloud/v1beta/get_archive' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response

v-1-beta-get-archive

POST
https://share.aws.us.pangea.cloud/v1beta/get_archive

Download an archive (tar or zip) containing the items identified by the ids in the ids array parameter.

See Transfer Methods for information on transfer_method.

fields

array<string>

The IDs of the objects to include in the archive. Folders include all children.

string

The format to use to build the archive.

string

The requested transfer method for the file data.

object

Pangea standard response schema

object

A response to a get_archive call.

integer

Number of objects included in the archive.

string

A location where the archive can be downloaded from. (transfer_method: dest-url)

array<object>

A list of all objects included in the archive.

integer

The number of billable bytes (includes Metadata, Tags, etc.) for the object.

string (date-time)

The date and time the object was created.

string

The ID of a stored object.

  • minLength: 36
string

The MD5 hash of the file contents. Cannot be written to.

object

A set of string-based key/value pairs used to provide additional data about an object.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

object

Protected (read-only) metadata.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

string

The SHA256 hash of the file contents. Cannot be written to.

string

The SHA512 hash of the file contents. Cannot be written to.

integer

The size of the object in bytes.

array<string>

A list of user-defined tags

array<string>

Protected (read-only) flags.

string

The type of the item (file or dir). Cannot be written to.

string (date-time)

The date and time the object was last updated.

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"
string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"
string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"
string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"
string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

post/v1beta/list
curl -sSLX POST 'https://share.aws.us.pangea.cloud/v1beta/list' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response

v-1-beta-list

POST
https://share.aws.us.pangea.cloud/v1beta/list

List files matching the given filter parameter.

Use the order parameter to specify “asc” for ascending, or “desc” for descending order of the results. Use the order_by parameter to specify which field the order parameter refers to. Use the size parameter to indicate the maximum number of results to include per call (for pagination of the results).

When paginating results, use the value of result.last from the response to the previous call as the value for the input parameter last. result.count from the response gives the total number of items matching the filter.

fields

object
string (date-time)

Only records where created_at equals this value.

string (date-time)

Only records where created_at is greater than this value.

string (date-time)

Only records where created_at is greater than or equal to this value.

string (date-time)

Only records where created_at is less than this value.

string (date-time)

Only records where created_at is less than or equal to this value.

string

Only records where the object exists in the supplied parent folder path name.

string

Only records where id equals this value.

array<string>

Only records where id equals one of the provided substrings.

string

Only records where name equals this value.

array<string>

Only records where name includes each substring.

array<string>

Only records where name equals one of the provided substrings.

string

Only records where parent_id equals this value.

array<string>

Only records where parent_id equals one of the provided substrings.

integer

Only records where size equals this value.

integer

Only records where size is greater than this value.

integer

Only records where size is greater than or equal to this value.

integer

Only records where size is less than to this value.

integer

Only records where size is less than or equal to this value.

array<string>

A list of tags that all must be present.

string

Only records where type equals this value.

array<string>

Only records where type includes each substring.

array<string>

Only records where type equals one of the provided substrings.

string (date-time)

Only records where updated_at equals this value.

string (date-time)

Only records where updated_at is greater than this value.

string (date-time)

Only records where updated_at is greater than or equal to this value.

string (date-time)

Only records where updated_at is less than this value.

string (date-time)

Only records where updated_at is less than or equal to this value.

string

Reflected value from a previous response to obtain the next page of results.

string

Order results asc(ending) or desc(ending).

string

Which field to order results by.

integer

Maximum results to include in the response.

  • minimum: 1
object

Pangea standard response schema

object
integer

The total number of objects matched by the list request.

string

Used to fetch the next page of the current listing when provided in a repeated request's last parameter.

array<object>
integer

The number of billable bytes (includes Metadata, Tags, etc.) for the object.

string (date-time)

The date and time the object was created.

string

The ID of a stored object.

  • minLength: 36
string

The MD5 hash of the file contents. Cannot be written to.

object

A set of string-based key/value pairs used to provide additional data about an object.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

object

Protected (read-only) metadata.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

string

The SHA256 hash of the file contents. Cannot be written to.

string

The SHA512 hash of the file contents. Cannot be written to.

integer

The size of the object in bytes.

array<string>

A list of user-defined tags

array<string>

Protected (read-only) flags.

string

The type of the item (file or dir). Cannot be written to.

string (date-time)

The date and time the object was last updated.

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"
string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"
string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"
string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"
string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

post/v1beta/put
curl -sSLX POST 'https://share.aws.us.pangea.cloud/v1beta/put' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: multipart/form-data'

Response

v-1-beta-put

POST
https://share.aws.us.pangea.cloud/v1beta/put

Upload a file with a given name to a given destination folder path in Secure Share.

You can use the path parameter alone to specify the full path to the named file for upload, OR you can use the parent_id (destination folder path) and the name (for the file name) parameters together.

See Transfer Methods for information on transfer_method.

required parameters

object
object
string

The transfer method used to upload the file data.

integer

The size (in bytes) of the file. If the upload doesn't match, the call will fail.

string

The hexadecimal-encoded CRC32C hash of the file data, which will be verified by the server if provided.

string

The SHA256 hash of the file data, which will be verified by the server if provided.

string

The hexadecimal-encoded MD5 hash of the file data, which will be verified by the server if provided.

string

The name of the object to store.

string

The format of the file, which will be verified by the server if provided. Uploads not matching the supplied format will be rejected.

object

A set of string-based key/value pairs used to provide additional data about an object.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

string

The MIME type of the file, which will be verified by the server if provided. Uploads not matching the supplied MIME type will be rejected.

string

The parent ID of the object (a folder). Leave blank to keep in the root folder.

  • minLength: 36
string

An optional path where the file should be placed. It will auto-create directories if necessary.

  • minLength: 1

  • maxLength: 256

string

An optional password to protect the file with. Downloading the file will require this password.

string

An optional password algorithm to protect the file with. See symmetric vault password_algorithm.

string

The hexadecimal-encoded SHA1 hash of the file data, which will be verified by the server if provided.

string

The hexadecimal-encoded SHA512 hash of the file data, which will be verified by the server if provided.

string

The URL to fetch the file payload from (for transfer_method source-url).

array<string>

A list of user-defined tags

object

Pangea standard response schema

object
object

The object that was created.

integer

The number of billable bytes (includes Metadata, Tags, etc.) for the object.

string (date-time)

The date and time the object was created.

string

The ID of a stored object.

  • minLength: 36
string

The MD5 hash of the file contents. Cannot be written to.

object

A set of string-based key/value pairs used to provide additional data about an object.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

object

Protected (read-only) metadata.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

string

The SHA256 hash of the file contents. Cannot be written to.

string

The SHA512 hash of the file contents. Cannot be written to.

integer

The size of the object in bytes.

array<string>

A list of user-defined tags

array<string>

Protected (read-only) flags.

string

The type of the item (file or dir). Cannot be written to.

string (date-time)

The date and time the object was last updated.

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"
string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"
string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"
string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"
string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

post/v1beta/update
curl -sSLX POST 'https://share.aws.us.pangea.cloud/v1beta/update' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response

v-1-beta-update

POST
https://share.aws.us.pangea.cloud/v1beta/update

Update information, such as tags or metadata, about an object by id OR bypath.

You can use the path parameter alone to specify the full path to the file, OR you can use the id of the file whose information is to be updated.

fields

string

An identifier for the file to update.

  • minLength: 36
string

An alternative to ID for identifying the target file.

  • minLength: 1

  • maxLength: 256

object

A list of Metadata key/values to set in the object. If a provided key exists, the value will be replaced.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

string

Protect the file with the supplied password.

string

The algorithm to use to password protect the file.

array<string>

A list of Tags to add. It is not an error to provide a tag which already exists.

string

Sets the object's Name.

object

Set the object's metadata.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

object

A list of metadata key/values to remove in the object. It is not an error for a provided key to not exist. If a provided key exists but doesn't match the provided value, it will not be removed.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

string

Remove the supplied password from the file.

array<string>

A list of tags to remove. It is not an error to provide a tag which is not present.

Set the parent (folder) of the object.

array<string>

Set the object's tags.

string (date-time)

The date and time the object was last updated. If included, the update will fail if this doesn't match the date and time of the last update for the object.

object

Pangea standard response schema

object
object
integer

The number of billable bytes (includes Metadata, Tags, etc.) for the object.

string (date-time)

The date and time the object was created.

string

The ID of a stored object.

  • minLength: 36
string

The MD5 hash of the file contents. Cannot be written to.

object

A set of string-based key/value pairs used to provide additional data about an object.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

object

Protected (read-only) metadata.

  • maxProperties: 256
string

  • minLength: 1

  • maxLength: 64

string

The SHA256 hash of the file contents. Cannot be written to.

string

The SHA512 hash of the file contents. Cannot be written to.

integer

The size of the object in bytes.

array<string>

A list of user-defined tags

array<string>

Protected (read-only) flags.

string

The type of the item (file or dir). Cannot be written to.

string (date-time)

The date and time the object was last updated.

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"
string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"
string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"
string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"
string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

post/v1beta/share/link/create
curl -sSLX POST 'https://share.aws.us.pangea.cloud/v1beta/share/link/create' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response

v-1-beta-share-link-create

POST
https://share.aws.us.pangea.cloud/v1beta/share/link/create

The link/create API takes an array of secure links objects and returns the result.share_link_object[] array containing a unique secured share link (result.share_link_objects[].link) for each of the elements in the links[].authenticators[] array .

links.targets[] is an array of object IDs for the file and/or folder objects that the link secures access to.

The links.link_type gives the type of link: download, upload, or editor. An upload type can only apply to a folder. Download and editor can apply to folders or files. Editor gives rename, delete, upload (put), and download (get) access to the objects listed in the links.targets[] array.

links[].expires_at gives the date and time that the secure link expires, and links[].max_access_count gives the maximum times a user can be authenticated to access a secure share link.

links[].authenticators[] is an array of authenticators objects, each of which contains an auth_type and an auth_context member. The links[].authenticators[].auth_type can be sms_otp, email_otp, or password, and the corresponding links[].authenticators[].auth_context must be the phone number (sms_otp), email address (email_otp), or password (password) to be used for securing the requested secure share link, which is returned in result.share_link_objects[].link.

links[].title and links[].message are optional parameters that can specify a title string and a message string to be used in notification emails and seen by the recipient when accessing shared content.

fields

array<object>

  • minItems: 1

  • maxItems: 100

array<string>

List of storage IDs

  • minItems: 1

  • maxItems: 1,000

string

Type of link

string (date-time)

The date and time the share link expires.

integer

The maximum number of times a user can be authenticated to access the share link.

array<object>

A list of authenticators

string

An authentication mechanism

An email address

string

An optional title to use in accessing shares.

string

An optional message to use in accessing shares.

string

An email address

array<string>

A list of user-defined tags

object

Pangea standard response schema

object
array<object>
string

The ID of a share link.

  • minLength: 36
string

The ID of a share bucket resource.

array<string>

List of storage IDs

  • minItems: 1

  • maxItems: 1,000

string

Type of link

integer

The number of times a user has authenticated to access the share link.

integer

The maximum number of times a user can be authenticated to access the share link.

string (date-time)

The date and time the share link was created.

string (date-time)

The date and time the share link expires.

string (date-time)

The date and time the share link was last accessed.

array<object>

A list of authenticators

  • minItems: 1

  • maxItems: 10

string

An authentication mechanism

An email address

string

An optional title to use in accessing shares.

string

An optional message to use in accessing shares.

string

A URL to access the file/folders shared with a link.

string

An email address

array<string>

A list of user-defined tags

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"
string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"
string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"
string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"
string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

post/v1beta/share/link/get
curl -sSLX POST 'https://share.aws.us.pangea.cloud/v1beta/share/link/get' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response

v-1-beta-share-link-get

POST
https://share.aws.us.pangea.cloud/v1beta/share/link/get

Get an existing secured share-link object by ID.

required parameters

string

The ID of a share link.

  • minLength: 36
object

Pangea standard response schema

object
object
string

The ID of a share link.

  • minLength: 36
string

The ID of a share bucket resource.

array<string>

List of storage IDs

  • minItems: 1

  • maxItems: 1,000

string

Type of link

integer

The number of times a user has authenticated to access the share link.

integer

The maximum number of times a user can be authenticated to access the share link.

string (date-time)

The date and time the share link was created.

string (date-time)

The date and time the share link expires.

string (date-time)

The date and time the share link was last accessed.

array<object>

A list of authenticators

  • minItems: 1

  • maxItems: 10

string

An authentication mechanism

An email address

string

An optional title to use in accessing shares.

string

An optional message to use in accessing shares.

string

A URL to access the file/folders shared with a link.

string

An email address

array<string>

A list of user-defined tags

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"
string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"
string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"
string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"
string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

post/v1beta/share/link/list
curl -sSLX POST 'https://share.aws.us.pangea.cloud/v1beta/share/link/list' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response

v-1-beta-share-link-list

POST
https://share.aws.us.pangea.cloud/v1beta/share/link/list

Return a list of existing secure share-links based on the given filter.

Use the order parameter to specify “asc” for ascending, or “desc” for descending order of the results. Use the order_by parameter to specify which field the order parameter refers to. Use the size parameter to indicate the maximum number of results to include per call (for pagination of the results). When paginating results, use the value of result.last from the response to the previous call as the value for the input parameter last. `result.count' from the response gives the total number of items matching the filter.

fields

object
string

Only records where id equals this value.

array<string>

Only records where id includes each substring.

array<string>

Only records where id equals one of the provided substrings.

string

Only records where storage_pool_id equals this value.

array<string>

Only records where storage_pool_id includes each substring.

array<string>

Only records where storage_pool_id equals one of the provided substrings.

string

Only records where target_id equals this value.

array<string>

Only records where target_id includes each substring.

array<string>

Only records where target_id equals one of the provided substrings.

string

Only records where link_type equals this value.

array<string>

Only records where link_type includes each substring.

array<string>

Only records where link_type equals one of the provided substrings.

integer

Only records where access_count equals this value.

integer

Only records where access_count is greater than this value.

integer

Only records where access_count is greater than or equal to this value.

integer

Only records where access_count is less than this value.

integer

Only records where access_count is less than or equal to this value.

integer

Only records where max_access_count equals this value.

integer

Only records where max_access_count is greater than this value.

integer

Only records where max_access_count is greater than or equal to this value.

integer

Only records where max_access_count is less than this value.

integer

Only records where max_access_count is less than or equal to this value.

string (date-time)

Only records where created_at equals this value.

string (date-time)

Only records where created_at is greater than this value.

string (date-time)

Only records where created_at is greater than or equal to this value.

string (date-time)

Only records where created_at is less than this value.

string (date-time)

Only records where created_at is less than or equal to this value.

string (date-time)

Only records where expires_at equals this value.

string (date-time)

Only records where expires_at is greater than this value.

string (date-time)

Only records where expires_at is greater than or equal to this value.

string (date-time)

Only records where expires_at is less than this value.

string (date-time)

Only records where expires_at is less than or equal to this value.

string (date-time)

Only records where last_accessed_at equals this value.

string (date-time)

Only records where last_accessed_at is greater than this value.

string (date-time)

Only records where last_accessed_at is greater than or equal to this value.

string (date-time)

Only records where last_accessed_at is less than this value.

string (date-time)

Only records where last_accessed_at is less than or equal to this value.

string

Only records where link equals this value.

array<string>

Only records where link includes each substring.

array<string>

Only records where link equals one of the provided substrings.

string

Only records where title equals this value.

array<string>

Only records where title includes each substring.

array<string>

Only records where title equals one of the provided substrings.

string

Only records where message equals this value.

array<string>

Only records where message includes each substring.

array<string>

Only records where message equals one of the provided substrings.

string

Only records where notify_email equals this value.

array<string>

Only records where notify_email includes each substring.

array<string>

Only records where notify_email equals one of the provided substrings.

array<string>

A list of tags that all must be present.

string

Reflected value from a previous response to obtain the next page of results.

string

Order results asc(ending) or desc(ending).

string

Which field to order results by.

integer

Maximum results to include in the response.

  • minimum: 1
object

Pangea standard response schema

object
integer

The total number of share links matched by the list request.

string

Used to fetch the next page of the current listing when provided in a repeated request's last parameter.

array<object>
string

The ID of a share link.

  • minLength: 36
string

The ID of a share bucket resource.

array<string>

List of storage IDs

  • minItems: 1

  • maxItems: 1,000

string

Type of link

integer

The number of times a user has authenticated to access the share link.

integer

The maximum number of times a user can be authenticated to access the share link.

string (date-time)

The date and time the share link was created.

string (date-time)

The date and time the share link expires.

string (date-time)

The date and time the share link was last accessed.

array<object>

A list of authenticators

  • minItems: 1

  • maxItems: 10

string

An authentication mechanism

An email address

string

An optional title to use in accessing shares.

string

An optional message to use in accessing shares.

string

A URL to access the file/folders shared with a link.

string

An email address

array<string>

A list of user-defined tags

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"
string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"
string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"
string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"
string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

post/v1beta/share/link/delete
curl -sSLX POST 'https://share.aws.us.pangea.cloud/v1beta/share/link/delete' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response

v-1-beta-share-link-delete

POST
https://share.aws.us.pangea.cloud/v1beta/share/link/delete

Delete a list of secured share-links by ID(s).

fields

array<string>

  • minItems: 1

  • maxItems: 100

object

Pangea standard response schema

object
array<object>
string

The ID of a share link.

  • minLength: 36
string

The ID of a share bucket resource.

array<string>

List of storage IDs

  • minItems: 1

  • maxItems: 1,000

string

Type of link

integer

The number of times a user has authenticated to access the share link.

integer

The maximum number of times a user can be authenticated to access the share link.

string (date-time)

The date and time the share link was created.

string (date-time)

The date and time the share link expires.

string (date-time)

The date and time the share link was last accessed.

array<object>

A list of authenticators

  • minItems: 1

  • maxItems: 10

string

An authentication mechanism

An email address

string

An optional title to use in accessing shares.

string

An optional message to use in accessing shares.

string

A URL to access the file/folders shared with a link.

string

An email address

array<string>

A list of user-defined tags

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"
string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"
string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"
string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"
string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

post/v1beta/share/link/send
curl -sSLX POST 'https://share.aws.us.pangea.cloud/v1beta/share/link/send' \
-H 'Authorization: Bearer <your_token>' \
-H 'Content-Type: application/json' \
-d '{}'

Response

v-1-beta-share-link-send

POST
https://share.aws.us.pangea.cloud/v1beta/share/link/send

Send a secure share-link notification to a set of email addresses.

The notification email will contain an Open button that the recipient can use to follow the secured share-link to authenticate and then access the shared content.

required parameters

array<object>

  • minItems: 1

  • maxItems: 100

string

The ID of a share link.

  • minLength: 36
string

An email address

string

An email address

string

The sender name information. Can be sender's full name for example.

object

Pangea standard response schema

object
array<object>
string

The ID of a share link.

  • minLength: 36
string

The ID of a share bucket resource.

array<string>

List of storage IDs

  • minItems: 1

  • maxItems: 1,000

string

Type of link

integer

The number of times a user has authenticated to access the share link.

integer

The maximum number of times a user can be authenticated to access the share link.

string (date-time)

The date and time the share link was created.

string (date-time)

The date and time the share link expires.

string (date-time)

The date and time the share link was last accessed.

array<object>

A list of authenticators

  • minItems: 1

  • maxItems: 10

string

An authentication mechanism

An email address

string

An optional title to use in accessing shares.

string

An optional message to use in accessing shares.

string

A URL to access the file/folders shared with a link.

string

An email address

array<string>

A list of user-defined tags

string

A unique identifier assigned to each request made to the API. It is used to track and identify a specific request and its associated data. The request_id can be helpful for troubleshooting, auditing, and tracing the flow of requests within the system. It allows users to reference and retrieve information related to a particular request, such as the response, parameters, and raw data associated with that specific request.

"request_id":"prq_x6fdiizbon6j3bsdvnpmwxsz2aan7fqd"
string

The timestamp indicates the exact moment when a request is made to the API. It represents the date and time at which the request was initiated by the client. The request_time is useful for tracking and analyzing the timing of requests, measuring response times, and monitoring performance metrics. It allows users to determine the duration between the request initiation and the corresponding response, aiding in the assessment of API performance and latency.

"request_time":"2022-09-21T17:24:33.105Z"
string

Duration it takes for the API to process a request and generate a response. It represents the elapsed time from when the request is received by the API to when the corresponding response is returned to the client.

"response_time":"2022-09-21T17:24:34.007Z"
string

It represents the status or outcome of the API request made for IP information. It indicates the current state or condition of the request and provides information on the success or failure of the request.

"status":"success"
string

Provides a concise and brief overview of the purpose or primary objective of the API endpoint. It serves as a high-level summary or description of the functionality or feature offered by the endpoint.

Was this article helpful?

Contact us