Links

The MASV API allows authorized users to manage download links for their packages. All requests require authentication using a package token authorized to manage the package. This can be retrieved from the access_token property in the Package response.

Creating links

Authorized users can create additional direct-download links or send a link to a specific email recipient after the upload has been finalized. To create a link, the package must be in the new or finalized state. Links created while the upload is in progress will remain inactive until the package is finalized.

Method	Route
POST	/packages/{package_id}/links

Headers

Name	Type	Required	Description
X-Package-Token	String	Yes	Package JSON Web Token
Content-Type	String	Yes	Must be application/json

Body

Name	Type	Required	Description
email	String	No	Recipient email address or empty for direct-download link
password	String	No	Password that user must enter before being able to view and download the package files

Request

curl -d '{"email":"$EMAIL", "password":"$PASSWORD"}' \
  -H "X-Package-Token: $PACKAGE_TOKEN" \
  -H "Content-Type: application/json" \
  -X POST https://api.massive.app/v1/packages/$PACKAGE_ID/links

Response

After a successful request, this endpoint returns 201 Created:

{
  "access_limit": 5,
  "access_limit_enabled": true,
  "active": true,
  "download_secret": "bqkBtnPwvmkgJpHN",
  "email": "[email protected]",
  "expiry": "2020-12-04T13:14:01.038Z",
  "id": "01EKX32ZSAPSCFC97W5Z423QKY",
  "password": "****"
}

Property	Description
access_limit	Number of times a download can be initiated using this link before it becomes locked
access_limit_enabled	Whether an access_limit is enforced
active	Whether the link can be used to download the package
id	Unique identifier for the link record
download_secret	A key provided with id to request a token to download the file
email	Recipient’s email (defaults to uploader email if not provided)
password	Indicates if a password is attached to the link. **** means a password is required

Note

Take note of the id and download_secret as they are required to access the download page. The download_secret is only returned in this response if the email is empty and cannot be retrieved via the API again.

Once the link has been created, an email will be sent to the recipient automatically (if provided) and it can be used to access the package on MASV via: https://get.massive.io/{link_id}?secret={download_secret}

Note

The request will need to be repeated for each additional email recipient or direct-download link you wish to create. Only one recipient per link may be specified.

List package links

Authorized users can retrieve a list of all links that belong to a package.

Method	Route
GET	/packages/{package_id}/links

Headers

Name	Type	Required	Description
X-Package-Token	String	Yes	Package JSON Web Token
Content-Type	String	Yes	Must be application/json

URL parameters

Name	Type	Required	Description
package_id	String	Yes	The package ID returned during create package request

Request

curl -H "X-Package-Token: $PACKAGE_TOKEN" \
  -H "Content-Type: application/json" \
  -X GET https://api.massive.app/v1/packages/$PACKAGE_ID/links

Response

This endpoint returns 200 OK with an array of link objects.

Disable a link

Authorized users can disable a download link to prevent new downloads and remove access to package details from the download page. The link record will remain for historical purposes.

Method	Route
DELETE	/packages/{package_id}/links/{link_id}

Headers

Name	Type	Required	Description
X-Package-Token	String	Yes	Package JSON Web Token
Content-Type	String	Yes	Must be application/json

URL parameters

Name	Type	Required	Description
package_id	String	Yes	The package ID
link_id	String	Yes	The link ID returned during create link request

Request

curl -H "X-Package-Token: $PACKAGE_TOKEN" \
  -H "Content-Type: application/json" \
  -X DELETE https://api.massive.app/v1/packages/$PACKAGE_ID/links/$LINK_ID

Response

This endpoint returns 204 No Content with an empty body. Any downloads in progress at the time of deletion may complete normally, but the download page will become inaccessible and new downloads cannot be started.