Graph API - V2 to V3 Transition Map

DOCUMENTATION

API V2 Documentation: https://intelligencebank.atlassian.net/wiki/spaces/APIDOC

API V3 Documentation: https://apidoc.intelligencebank.com

PRODUCT KEY

If applicable, the product key is to be added under Params as:

productkey={{provided_value}}

This applies to all calls, including when POST.

FIELD NAMES

Note that field / attribute names can differ between V2 and V3 responses.

CALLS MAPPING

V2 Call

V3 Call

Comments (GAPS are highlighted in bold)

V2 Call

V3 Call

Comments (GAPS are highlighted in bold)

Login / Authentication (POST)

NA

  • V2 Login / Authentication to still be used, including for the Browser Login option (if implemented).

  • The following parameters returned in the response are to be used for subsequent V3 calls:

    • “apiV3url”

    • “clientid”

    • “sid” (in headers)

Root Folders (GET)

Call to get the root list of folders.

Folders List (GET)

 

  • Get root Folders and get sub-folders are now part of the same base call.

Folder Content (GET)

Folders List (GET)

Resources List (GET)

Resources List (POST - for advanced search queries)

Public Share Link Request (GET)

  • Resources and Sub-Folders are now retrieved via 2 separate calls.

  • Check the count on the parent folder to know if there are sub-folders or resources to retrieve.

  • To get sub-folders, simply include the parent folder uuid in Params of the Folders List call.

  • “publicURL” parameter is not returned in the Resources List call anymore. A dedicated “Public Share Link” call is now available to get that information for any asset that is listed as isPublic = true in the Resources List response.

  • Thumbnail URL is to be retrieved in “thumbnail” parameter.

A “V3thumbnail” is currently returned for images, but will be changed back to use “thumbnail” at the end of October 2020 once all filetypes are migrated to our new preview generation code.

Download File (GET)

Download File (GET)

  • Note that Presets can now be requested for download directly via a Preset id.

Download File Preview (GET)

Download File Preview (GET)

 

Download Image With Transformations (GET)

Download File (GET)

  • Ability to get File Size estimate is not available in V3 at this point, and still pending scheduling and development.

    • V2 call can still be used for now.

Presets List (GET)

Presets List (GET)

  • Files can now have their own individual presets (i.e. Single Presets).

Thumbnail Icon (GET)

Folders List (GET)

Resources List (GET)

  • Thumbnail icons are now returned as a field of folder or resource object (“thumbnail”).

A “V3thumbnail” is currently returned for images, but will be changed back to use “thumbnail” at the end of October 2020 once all filetypes are migrated to our new preview generation code.

Create Resource (POST)

Update Resource (PUT / POST)

File Upload (POST)

Create Resource (POST)

Update Resource (PUT)

  • Upload of the file itself is now separated from creating or updating the resource.

Delete Resource (DELETE)

Delete Resource (DELETE)

 

Create Folder (POST)

Create Folder (POST)

  • Note the current limitations in the V3 call description.

Sync Call (GET)

Resource List (GET)

Resource Info (GET)

Folder Info (GET) - TBD

  • No directly equivalent call - request specific objects directly to view their Info in V3:

    • For Resources: You can use Resources List (GET or POST) with searchParams[keywords] applied (multiple UUIDs can be included in a single request, e.g. UUID1 UUID2 UUID3).

    • For Folders: Use Folder List (GET) searchParams[keywords] applied (multiple UUIDs can be included in a single request, e.g. UUID1 UUID2 UUID3).