Apps

An App represents one of the various integrations provided by Files.com. These are what are listed in the Integrations Catalog in the web interface.

Currently, all apps are developed internally by Files.com, though we do have the infrastructure to support vendor-developed apps. If you are a third party vendor interested in developing for the Files.com ecosystem, please contact us. We'd love to hear more.

List Apps

Endpoint

GET/apps

Return Object

App[]

Authorization Requirement

No authentication required; you may call this endpoint without a key or session.

Additional Arguments

Example Request

curl https://app.files.com/api/rest/v1/apps.json \
  -H 'X-FilesAPI-Key: YOUR_API_KEY'

Example Response

[
  {
    "app_type": "example",
    "documentation_links": {
      "Important Info": "http://files.test/learn-more"
    },
    "extended_description": "example",
    "extended_description_for_marketing_site": "example",
    "external_homepage_url": "example",
    "featured": true,
    "folder_behavior_type": "example",
    "icon_url": "example",
    "logo_thumbnail_url": "example",
    "logo_url": "example",
    "marketing_intro": "example",
    "marketing_youtube_url": "example",
    "name": "example",
    "package_manager_install_command": "example",
    "remote_server_type": "example",
    "screenshot_list_urls": [
      "example"
    ],
    "sdk_installation_instructions_link": "example",
    "short_description": "example",
    "sso_strategy_type": "example",
    "siem_type": "example",
    "tutorial_youtube_url": "example"
  }
]

The App Object

Some of the endpoints above return a App object. The attributes of this object are listed below.

Attribute	Description
app_type string	The type of the App Possible values: `sdk`, `sso`, `remote_server`, `folder_behavior`, `client_app`, `app_integration`, `siem`
documentation_links object	Collection of named links to documentation
extended_description string	Long description for the in-App landing page
extended_description_for_marketing_site string	Long form description of the App
external_homepage_url string	Link to external homepage
featured boolean	Is featured on the App listing?
folder_behavior_type string	Associated Folder Behavior type, if any Possible values: `webhook`, `file_expiration`, `auto_encrypt`, `lock_subfolders`, `storage_region`, `serve_publicly`, `create_user_folders`, `inbox`, `limit_file_extensions`, `limit_file_regex`, `amazon_sns`, `watermark`, `remote_server_mount`, `slack_webhook`, `auto_decrypt`, `override_upload_filename`, `permission_fence`, `limit_filename_length`, `organize_files_into_subfolders`, `teams_webhook`, `google_pub_sub`, `archive_overwritten_or_deleted_files`, `auto_recrypt`, `metadata_category`, `auto_unzip`, `remote_server_metadata_index`, `malware_scanning`
icon_url string	App icon
logo_thumbnail_url string	Logo thumbnail for the App
logo_url string	Full size logo for the App
marketing_intro string	Marketing introdution of the App
marketing_youtube_url string	Marketing video page
name string	Name of the App
package_manager_install_command string	Package manager install command
remote_server_type string	Associated Remote Server type, if any Possible values: `ftp`, `sftp`, `s3`, `google_cloud_storage`, `webdav`, `wasabi`, `backblaze_b2`, `one_drive`, `box`, `dropbox`, `google_drive`, `azure`, `sharepoint`, `s3_compatible`, `azure_files`, `files_agent`, `filebase`, `cloudflare`, `linode`, `files_com`
screenshot_list_urls array(string)	Screenshots of the App
sdk_installation_instructions_link string	Link to SDK installation instructions
short_description string	Short description of the App
sso_strategy_type string	Associated SSO Strategy type, if any Possible values: `google`, `auth0`, `okta`, `azure`, `box`, `dropbox`, `slack`, `onelogin`, `saml`, `idaptive`, `ldap`, `scim`, `jumpcloud`, `duo`
siem_type string	Associated SIEM type, if any Possible values: `generic`, `splunk`, `azure_legacy`, `qradar`, `sumo`, `rapid7`, `solar_winds`, `new_relic`, `datadog`, `azure`, `file`, `crowdstrike`, `splunk_compatible`
tutorial_youtube_url string	Tutorial video page

Example App Object

{
  "app_type": "example",
  "documentation_links": {
    "Important Info": "http://files.test/learn-more"
  },
  "extended_description": "example",
  "extended_description_for_marketing_site": "example",
  "external_homepage_url": "example",
  "featured": true,
  "folder_behavior_type": "example",
  "icon_url": "example",
  "logo_thumbnail_url": "example",
  "logo_url": "example",
  "marketing_intro": "example",
  "marketing_youtube_url": "example",
  "name": "example",
  "package_manager_install_command": "example",
  "remote_server_type": "example",
  "screenshot_list_urls": [
    "example"
  ],
  "sdk_installation_instructions_link": "example",
  "short_description": "example",
  "sso_strategy_type": "example",
  "siem_type": "example",
  "tutorial_youtube_url": "example"
}