Platform Legal Agreement

Manage the platform legal agreement.

Table of Contents

You might want to have a platform legal agreement in place, that all platform users are required to accept. If a legal agreement is in place, the platform requires users to accept the agreement in these scenarios:

  • As part of completing the initial login process.
  • On next login if the legal agreement changes.

You can upload more than one agreement document, but only one can be active. You can change the legal agreement at any time, or deactivate it. Remember that every time you change the legal agreement, every user must accept the new agreement at next login.

Note: The platform supports use of only one legal agreement. Make sure all the legal requirements are combined into one document.

The following file formats are supported for legal agreements on the platform:

  • Text (.txt, .text)
  • HTML (.htm, .html)
  • PDF (.pdf)

Note: Supported file formats are the same for these two types of legal agreements supported on the platform:

  • Platform signup legal agreement: If a platform signup legal agreement is in place, all platform users much accept the agreement.
  • API legal agreement: Specific to an API. Must be accepted as part of requesting access to an API (API > Overview > Access).

To add a legal agreement there are two steps:

  1. First, upload the legal agreement file to the content/system/agreements folder. See Step 1: To upload a new legal agreement to the Akana API platform below.
  2. Then, make the new agreement the default for the platform. See Step 2: To set a specific legal agreement as the default for the platform below.

Note: Follow the procedure below to upload a legal agreement directly to the correct folder. This is the fastest way to do it. However, you can also upload via More > Admin >File Manager. In the Content section, click File Manager. You'd then need to create the rest of the folder structure before uploading the file. It doesn't matter how the legal agreement is uploaded but it must be in the content/system/agreements folder.

  1. Log in as a Site Admin and go to the Admin section.
  2. Go to More > Admin >Agreements.
  3. Click Upload Agreement.

    Note: this functionality is only available to the Site Admin. If you don't see the Upload Agreement button on the right, you don't have the appropriate permissions.

  4. In File Manager, click Upload a File, then navigate to the location of the new developer agreement and upload it. The content is uploaded automatically to the content/system/agreements folder.
  5. For supported file types, see What file formats are supported for the platform signup legal agreement?

Once you've uploaded the legal agreement, the next step is to make it the default for the platform. See below.

Before setting the legal agreement as the default for the platform, you must upload it. See Step 1 above.

  1. Log in as a Site Admin and go to the Admin section.
  2. Go to More > Admin >Agreements.
  3. Click Add Agreement.

    Note: this functionality is only available to the Site Admin. If you don't see the Add Agreement button on the right, you don't have the appropriate permissions.

  4. Specify values (all fields are required):
    • Name: Used internally.
    • Description: Displayed to users above the legal agreement when the user is logging in for the first time, or at the next login if the legal agreement changes.
    • Content Path: Browse for the agreement users must accept. You can only choose a file previously uploaded to the content/system/agreements folder as per Step 1 above.
    • Printable Content Path: Browse for the agreement users can print. You can only choose a file previously uploaded to the content/system/agreements folder as per Step 1 above. It can be the same file that you used in the Content Path field, or a more print-friendly file format such as PDF.
  5. Click Finish. The legal agreement immediately becomes the default for the platform, and new or existing users will need to accept it to log in.

Note: You can upload more than one legal agreement. If you have more than one, they display in a list view in the Legal Agreements page. However, only one can be active.

If you have a legal agreement in place, and want to deactivate it or change to a different one, you can do that in the Agreements page.

If you are changing to a new legal agreement, upload the file to the platform first; follow the steps in To upload a new legal agreement to the Akana API platform above.

To change an existing platform signup legal agreement

  1. Log in as a Site Admin and go to the Admin section.
  2. Go to More > Admin >Agreements.
  3. On the Legal Agreements page, find the agreement. Click the Actions drop-down menu at the right and choose Edit Agreement.
  4. On the Edit Agreement page, modify one or more values as needed. For information about the fields, see To set a specific legal agreement as the default for the platform above.
  5. Click Finish. The revised legal agreement immediately becomes the default for the platform, and new or existing users will need to accept it to log in.

If you have a legal agreement in place, and want to deactivate it so that platform users no longer need to accept the legal agreement, you can do that on the More > Admin >Agreements page.

To deactivate an existing legal agreement

  1. Log in as a Site Admin and go to the Admin section.
  2. Go to More > Admin >Agreements.
  3. On the Legal Agreements page, find the agreement. Click the Actions drop-down menu at the right and choose Deactivate Agreement.
  4. At the confirmation message, click OK. The agreement is immediately deactivated.