Application Permissions

This page covers the various application permissions made available for app developers. The permissions below can be easily assigned to an application by adding them to the app’s manifest file.

In combination with an App Access Token these permissions authorize apps during server-to-server communication.

The permissions listed under Controlled Permissions are only available at the discretion of Speakap and cannot be added to your manifests.

Permissions

access_statistics:
 

This permission grants application access to various network usage statistics such as number of pending/activated users, users sessions.

get_network_timeline:
 

With this permission applications are able to retrieve the network timeline, containing only those messages sent to the whole network.

get_group_timelines:
 

Besides the network timeline it’s possible to retrieve messages sent to groups. This permission let’s you do just that.

get_profiles:

Applications with this permission have access to query user profiles, including user names, avatars, contact information, etc.

get_profile_status:
 

Applications with this permission have access to query the status of user profiles. The status indicates whether the profile has been activated, deleted, etc.

Note

No personal information about the user is revealed.

get_profile_xid:
 

This permissions lets applications retrieve the external identifier of user profiles. This identifier (XID) can be used to synchronize profile data with an external source.

get_user_groups:
 

Applications with this permission can retrieve the groups a user is member of.

infinite_limit:

In combination with content type minimal+json this can be used by applications to retrieve a limitless collection. This is convenient, for example, when you want to have returned all network groups in a single response.

invite_users:

This permissions gives applications the ability to invite users to the network.

list_groups:

This permissions gives applications the ability to discover all networks groups through the groups collection.

list_group_members:
 

Add this permission to your application’s manifest to get an overview of all users who are member of particular group.

post_to_any_group:
 

By default applications can only post to the network timeline or a user’s personal timeline. This permissions lets you post updates to any of the groups in an network.

post_updates:

Applications with this permission can post updates on timelines.

send_alerts:

Applications with this permission can send alerts to users.

upload_files:

Give your application permission to upload files by adding this permissions to its manifest.

upload_into_folders:
 

Applications with this permission can specify a destination folder when uploading files.

Note

Only useful in combination with upload_files permission.

Controlled permissions

edit_network_features:
 This permissions gives applications the ability to change the features that are enabled for a network.
edit_network_subscription:
 This permissions gives applications the ability to change the subscription status of a network.
list_networks:This permissions gives applications the ability to discover all available networks through the networks collection.