Appearance
Common
About 20563 wordsAbout 69 min
Php SDK - Feeds API
Table of Contents
- getApp
- updateApp
- listBlockLists
- createBlockList
- getBlockList
- updateBlockList
- deleteBlockList
- checkPush
- checkSNS
- checkSQS
- listDevices
- createDevice
- deleteDevice
- exportUsers
- listExternalStorage
- createExternalStorage
- updateExternalStorage
- deleteExternalStorage
- checkExternalStorage
- createGuest
- createImportURL
- listImports
- createImport
- listImportV2Tasks
- createImportV2Task
- getImporterExternalStorage
- upsertImporterExternalStorage
- deleteImporterExternalStorage
- validateImporterExternalStorage
- getImportV2Task
- deleteImportV2Task
- getImport
- getOG
- listPermissions
- getPermission
- createPoll
- updatePoll
- queryPolls
- getPoll
- updatePollPartial
- deletePoll
- createPollOption
- updatePollOption
- getPollOption
- deletePollOption
- queryPollVotes
- updatePushNotificationPreferences
- listPushProviders
- upsertPushProvider
- deletePushProvider
- getPushTemplates
- upsertPushTemplate
- getRateLimits
- listRoles
- createRole
- deleteRole
- getTask
- uploadFile
- deleteFile
- uploadImage
- deleteImage
- listUserGroups
- createUserGroup
- searchUserGroups
- getUserGroup
- updateUserGroup
- deleteUserGroup
- addUserGroupMembers
- removeUserGroupMembers
- queryUsers
- updateUsers
- updateUsersPartial
- getBlockedUsers
- blockUsers
- deactivateUsers
- deleteUsers
- getUserLiveLocations
- updateLiveLocation
- reactivateUsers
- restoreUsers
- unblockUsers
- deactivateUser
- exportUser
- reactivateUser
- Types Reference
getApp
Retrieve the current application settings to understand and verify the configuration of your app. Use this method when you need to access or review the app's settings for troubleshooting or validation purposes.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get App Settings
$response = $client->getApp();
print_r($response->getData());Response: GetApplicationResponse
updateApp
Modify the application settings to adjust the configuration according to your requirements. This method is useful when you need to update settings to improve functionality or comply with new policies.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updateAppRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update App Settings
$response = $client->updateApp(
new updateAppRequest(
activityMetricsConfig: {},
allowedFlagReasons: [],
apnConfig: ['Disabled' => false],
)
);
print_r($response->getData());Example: with async_moderation_config and async_url_enrich_enabled
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updateAppRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update App Settings
$response = $client->updateApp(
new updateAppRequest(
asyncModerationConfig: ['callback' => ['mode' => 'value']],
asyncURLEnrichEnabled: false,
)
);
print_r($response->getData());Example: with auto_translation_enabled and before_message_send_hook_url
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updateAppRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update App Settings
$response = $client->updateApp(
new updateAppRequest(
autoTranslationEnabled: false,
beforeMessageSendHookURL: 'value',
)
);
print_r($response->getData());Example: with cdn_expiration_seconds and channel_hide_members_only
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updateAppRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update App Settings
$response = $client->updateApp(
new updateAppRequest(
cdnExpirationSeconds: 10,
channelHideMembersOnly: false,
)
);
print_r($response->getData());Response: Response
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| activity_metrics_config | array | No | - |
| allowed_flag_reasons | []string | No | - |
| apn_config | APNConfig | No | - |
| async_moderation_config | AsyncModerationConfiguration | No | - |
| async_url_enrich_enabled | bool | No | - |
| auto_translation_enabled | bool | No | - |
| before_message_send_hook_url | string | No | - |
| cdn_expiration_seconds | int | No | - |
| channel_hide_members_only | bool | No | - |
| custom_action_handler_url | string | No | - |
| datadog_info | DataDogInfo | No | - |
| disable_auth_checks | bool | No | - |
| disable_permissions_checks | bool | No | - |
| enforce_unique_usernames | string | No | - |
| event_hooks | []EventHook | No | - |
| feeds_moderation_enabled | bool | No | - |
| feeds_v2_region | string | No | - |
| file_upload_config | FileUploadConfig | No | - |
| firebase_config | FirebaseConfig | No | - |
| grants | array | No | - |
| guest_user_creation_disabled | bool | No | - |
| huawei_config | HuaweiConfig | No | - |
| image_moderation_block_labels | []string | No | - |
| image_moderation_enabled | bool | No | - |
| image_moderation_labels | []string | No | - |
| image_upload_config | FileUploadConfig | No | - |
| max_aggregated_activities_length | int | No | - |
| migrate_permissions_to_v2 | bool | No | - |
| moderation_analytics_enabled | bool | No | - |
| moderation_dashboard_preferences | ModerationDashboardPreferences | No | - |
| moderation_enabled | bool | No | - |
| moderation_s3_image_access_role_arn | string | No | - |
| moderation_webhook_url | string | No | - |
| multi_tenant_enabled | bool | No | - |
| permission_version | string | No | - |
| push_config | PushConfig | No | - |
| reminders_interval | int | No | - |
| reminders_max_members | int | No | - |
| revoke_tokens_issued_before | float | No | - |
| sns_key | string | No | - |
| sns_secret | string | No | - |
| sns_topic_arn | string | No | - |
| sqs_key | string | No | - |
| sqs_secret | string | No | - |
| sqs_url | string | No | - |
| user_response_time_enabled | bool | No | - |
| user_search_disallowed_roles | []string | No | - |
| webhook_events | []string | No | - |
| webhook_url | string | No | - |
| xiaomi_config | XiaomiConfig | No | - |
listBlockLists
Obtain a list of all block lists to manage or review the existing lists effectively. Use this method when you need a comprehensive overview of all block lists in your system.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// List block lists
$response = $client->listBlockLists(
'value'
);
print_r($response->getData());Response: ListBlockListResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| team | string | No | - |
createBlockList
Establish a new block list to prevent certain elements from interacting with your application. This method is essential when introducing new restrictions or security measures.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createBlockListRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create block list
$response = $client->createBlockList(
new createBlockListRequest(
name: 'My Feed',
words: [],
type: 'like',
isPluralCheckEnabled: false,
)
);
print_r($response->getData());Example: with team and is_leet_check_enabled
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createBlockListRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create block list
$response = $client->createBlockList(
new createBlockListRequest(
name: 'My Feed',
words: [],
team: 'value',
isLeetCheckEnabled: false,
)
);
print_r($response->getData());Response: CreateBlockListResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | Block list name |
| words | []string | Yes | List of words to block |
| is_leet_check_enabled | bool | No | - |
| is_plural_check_enabled | bool | No | - |
| team | string | No | - |
| type | string | No | Block list type. One of: regex, domain, domain_allowlist, email, email_allowlist, word |
getBlockList
Access the details of a specific block list to understand its contents and purpose. Use this method when you need to inspect or verify the entries of a particular block list.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get block list
$response = $client->getBlockList(
'My Feed',
'value'
);
print_r($response->getData());Response: GetBlockListResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | - |
| team | string | No | - |
updateBlockList
Modify an existing block list to add, remove, or change its entries. This is useful when updating the list to reflect new restrictions or allow previously blocked interactions.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updateBlockListRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update block list
$response = $client->updateBlockList(
'My Feed',
new updateBlockListRequest(
isLeetCheckEnabled: false,
isPluralCheckEnabled: false,
)
);
print_r($response->getData());Example: with team and words
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updateBlockListRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update block list
$response = $client->updateBlockList(
'My Feed',
new updateBlockListRequest(
team: 'value',
words: [],
)
);
print_r($response->getData());Response: UpdateBlockListResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | - |
| is_leet_check_enabled | bool | No | - |
| is_plural_check_enabled | bool | No | - |
| team | string | No | - |
| words | []string | No | List of words to block |
deleteBlockList
Remove a block list to eliminate its restrictions from your application. Use this method when a block list is no longer needed, or when consolidating lists for efficiency.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete block list
$response = $client->deleteBlockList(
'My Feed',
'value'
);
print_r($response->getData());Response: Response
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | - |
| team | string | No | - |
checkPush
Verify the configuration and status of push notification services to ensure they are functioning correctly. This method is beneficial when diagnosing issues or confirming the setup of push notifications.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\checkPushRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Check push
$response = $client->checkPush(
new checkPushRequest(
userID: 'john',
eventType: 'value',
firebaseDataTemplate: 'value',
)
);
print_r($response->getData());Example: with firebase_template and message_id
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\checkPushRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Check push
$response = $client->checkPush(
new checkPushRequest(
firebaseTemplate: 'value',
messageID: 'value',
)
);
print_r($response->getData());Example: with push_provider_name and push_provider_type
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\checkPushRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Check push
$response = $client->checkPush(
new checkPushRequest(
pushProviderName: 'value',
pushProviderType: 'value',
)
);
print_r($response->getData());Example: with skip_devices and user
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\checkPushRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Check push
$response = $client->checkPush(
new checkPushRequest(
skipDevices: false,
user: ['id' => 'activity-123', 'custom' => {}],
)
);
print_r($response->getData());Response: CheckPushResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| apn_template | string | No | Push message template for APN |
| event_type | string | No | Type of event for push templates (default: message.new). One of: message.new, message.updated, re... |
| firebase_data_template | string | No | Push message data template for Firebase |
| firebase_template | string | No | Push message template for Firebase |
| message_id | string | No | Message ID to send push notification for |
| push_provider_name | string | No | Name of push provider |
| push_provider_type | string | No | Push provider type. One of: firebase, apn, huawei, xiaomi |
| skip_devices | bool | No | Don't require existing devices to render templates |
| user | UserRequest | No | - |
| user_id | string | No | - |
checkSNS
Check the configuration and status of SNS (Simple Notification Service) to ensure proper operation. Use this method when you need to troubleshoot or validate SNS integration.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\checkSNSRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Check SNS
$response = $client->checkSNS(
new checkSNSRequest(
snsKey: 'value',
snsSecret: 'value',
snsTopicArn: 'value',
)
);
print_r($response->getData());Response: CheckSNSResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| sns_key | string | No | AWS SNS access key |
| sns_secret | string | No | AWS SNS key secret |
| sns_topic_arn | string | No | AWS SNS topic ARN |
checkSQS
Assess the configuration and status of SQS (Simple Queue Service) to ensure messages are being processed correctly. This is helpful for troubleshooting issues or confirming the setup of SQS.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\checkSQSRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Check SQS
$response = $client->checkSQS(
new checkSQSRequest(
sqsKey: 'value',
sqsSecret: 'value',
sqsURL: 'value',
)
);
print_r($response->getData());Response: CheckSQSResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| sqs_key | string | No | AWS SQS access key |
| sqs_secret | string | No | AWS SQS key secret |
| sqs_url | string | No | AWS SQS endpoint URL |
listDevices
Retrieve a comprehensive list of all registered devices, useful for monitoring and managing device inventory.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// List devices
$response = $client->listDevices(
'john'
);
print_r($response->getData());Response: ListDevicesResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | No | - |
createDevice
Add a new device to your system, ideal for onboarding new hardware into your network.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createDeviceRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create device
$response = $client->createDevice(
new createDeviceRequest(
id: 'activity-123',
pushProvider: 'value',
userID: 'john',
user: ['id' => 'activity-123', 'custom' => {}],
)
);
print_r($response->getData());Example: with push_provider_name and voip_token
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createDeviceRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create device
$response = $client->createDevice(
new createDeviceRequest(
id: 'activity-123',
pushProvider: 'value',
pushProviderName: 'value',
voipToken: false,
)
);
print_r($response->getData());Response: Response
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Device ID |
| push_provider | string | Yes | Push provider |
| push_provider_name | string | No | Push provider name |
| user | UserRequest | No | - |
| user_id | string | No | Server-side only. User ID which server acts upon |
| voip_token | bool | No | When true the token is for Apple VoIP push notifications |
deleteDevice
Remove a specific device from your records, perfect for decommissioning or replacing outdated equipment.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete device
$response = $client->deleteDevice(
'activity-123',
'john'
);
print_r($response->getData());Response: Response
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | - |
| user_id | string | No | - |
exportUsers
Generate and download a complete list of users, helpful for data analysis or migration to other systems.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\exportUsersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Export users
$response = $client->exportUsers(
new exportUsersRequest(
userIds: ['user-1', 'user-2'],
)
);
print_r($response->getData());Response: ExportUsersResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_ids | []string | Yes | - |
listExternalStorage
Get an overview of all configured external storage options, useful for managing and optimizing data storage solutions.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// List external storage
$response = $client->listExternalStorage();
print_r($response->getData());Response: ListExternalStorageResponse
createExternalStorage
Set up a new external storage configuration, enabling you to expand your data storage capabilities.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createExternalStorageRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create external storage
$response = $client->createExternalStorage(
new createExternalStorageRequest(
bucket: 'value',
name: 'My Feed',
storageType: 'value',
awsS3: ['s3_region' => 'value', 's3_api_key' => 'value'],
azureBlob: ['abs_account_name' => 'value', 'abs_client_id' => 'value', 'abs_client_secret' => 'value', 'abs_tenant_id' => 'value'],
)
);
print_r($response->getData());Example: with gcs_credentials and path
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createExternalStorageRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create external storage
$response = $client->createExternalStorage(
new createExternalStorageRequest(
bucket: 'value',
name: 'My Feed',
storageType: 'value',
gcsCredentials: 'value',
path: 'value',
)
);
print_r($response->getData());Response: CreateExternalStorageResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| bucket | string | Yes | The name of the bucket on the service provider |
| name | string | Yes | The name of the provider, this must be unique |
| storage_type | string | Yes | The type of storage to use |
| aws_s3 | S3Request | No | Only required if you want to create an Amazon S3 storage |
| azure_blob | AzureRequest | No | Only required if you want to create an Azure Blob Storage |
| gcs_credentials | string | No | - |
| path | string | No | The path prefix to use for storing files |
updateExternalStorage
Modify an existing external storage setup, allowing for adjustments in storage parameters or credentials.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updateExternalStorageRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update External Storage
$response = $client->updateExternalStorage(
'My Feed',
new updateExternalStorageRequest(
bucket: 'value',
storageType: 'value',
awsS3: ['s3_region' => 'value', 's3_api_key' => 'value'],
azureBlob: ['abs_account_name' => 'value', 'abs_client_id' => 'value', 'abs_client_secret' => 'value', 'abs_tenant_id' => 'value'],
)
);
print_r($response->getData());Example: with gcs_credentials and path
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updateExternalStorageRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update External Storage
$response = $client->updateExternalStorage(
'My Feed',
new updateExternalStorageRequest(
bucket: 'value',
storageType: 'value',
gcsCredentials: 'value',
path: 'value',
)
);
print_r($response->getData());Response: UpdateExternalStorageResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | - |
| bucket | string | Yes | The name of the bucket on the service provider |
| storage_type | string | Yes | The type of storage to use |
| aws_s3 | S3Request | No | Only required if you want to create an Amazon S3 storage |
| azure_blob | AzureRequest | No | Only required if you want to create an Azure Blob Storage |
| gcs_credentials | string | No | - |
| path | string | No | The path prefix to use for storing files |
deleteExternalStorage
Remove an external storage configuration, useful for retiring or replacing storage solutions.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete external storage
$response = $client->deleteExternalStorage(
'My Feed'
);
print_r($response->getData());Response: DeleteExternalStorageResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | - |
checkExternalStorage
Verify the status and connectivity of an external storage system, ensuring reliable data access and storage integrity.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Check External Storage
$response = $client->checkExternalStorage(
'My Feed'
);
print_r($response->getData());Response: CheckExternalStorageResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | - |
createGuest
Register a temporary guest user, ideal for providing limited access to your system without creating a permanent account.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createGuestRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create Guest
$response = $client->createGuest(
new createGuestRequest(
user: ['id' => 'activity-123', 'custom' => {}],
)
);
print_r($response->getData());Response: CreateGuestResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user | UserRequest | Yes | User object which server acts upon |
createImportURL
Generates a URL for importing data into the system, useful for initiating data imports via a web link.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createImportURLRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create import URL
$response = $client->createImportURL(
new createImportURLRequest(
filename: 'value',
)
);
print_r($response->getData());Response: CreateImportURLResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| filename | string | No | - |
listImports
Retrieves a list of all active and completed data imports, helping users track the status and history of their import activities.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get import
$response = $client->listImports();
print_r($response->getData());Response: ListImportsResponse
createImport
Initiates a new data import process, allowing users to bring external data into the system for further analysis or usage.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createImportRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create import
$response = $client->createImport(
new createImportRequest(
mode: 'value',
path: 'value',
mergeCustom: false,
)
);
print_r($response->getData());Response: CreateImportResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| mode | string | Yes | - |
| path | string | Yes | - |
| merge_custom | bool | No | - |
listImportV2Tasks
Provides a list of all tasks associated with the version 2 import process, enabling users to monitor and manage complex data import operations.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// List import v2 tasks
$response = $client->listImportV2Tasks(
10
);
print_r($response->getData());Response: ListImportV2TasksResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| state | int | No | - |
createImportV2Task
Starts a new task within the version 2 import framework, offering more granular control over individual data import operations.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createImportV2TaskRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create import v2 task
$response = $client->createImportV2Task(
new createImportV2TaskRequest(
product: 'value',
settings: ['merge_custom' => false],
userID: 'john',
user: ['id' => 'activity-123', 'custom' => {}],
)
);
print_r($response->getData());Response: CreateImportV2TaskResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| product | string | Yes | - |
| settings | ImportV2TaskSettings | Yes | - |
| user | UserRequest | No | - |
| user_id | string | No | - |
getImporterExternalStorage
Retrieve details about an external storage configuration. Use this method to check the settings of a previously configured external storage system.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get external storage
$response = $client->getImporterExternalStorage();
print_r($response->getData());Response: GetExternalStorageResponse
upsertImporterExternalStorage
Create or update an external storage configuration. Use this method to ensure your external storage settings are current and correct.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\upsertImporterExternalStorageRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Upsert external storage
$response = $client->upsertImporterExternalStorage(
new upsertImporterExternalStorageRequest(
type: 'like',
awsS3: ['bucket' => 'value', 'region' => 'value', 'role_arn' => 'value', 'path_prefix' => 'value'],
)
);
print_r($response->getData());Response: UpsertExternalStorageResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| type | string | Yes | - |
| aws_s3 | UpsertExternalStorageAWSS3Request | No | - |
deleteImporterExternalStorage
Remove an existing external storage configuration. Use this method when you want to disconnect or clean up unused storage settings.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete external storage
$response = $client->deleteImporterExternalStorage();
print_r($response->getData());Response: DeleteExternalStorageResponse
validateImporterExternalStorage
Verify the connectivity and configuration of an external storage system. Use this method to test and confirm that your external storage setup is functioning properly.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Validate external storage
$response = $client->validateImporterExternalStorage();
print_r($response->getData());Response: ValidateExternalStorageResponse
getImportV2Task
Fetches detailed information about a specific version 2 import task, allowing users to check the progress and details of their import activities.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get import v2 task
$response = $client->getImportV2Task(
'activity-123'
);
print_r($response->getData());Response: GetImportV2TaskResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | - |
deleteImportV2Task
Removes a specific task from the version 2 import process, useful for canceling unwanted or erroneous data import operations.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete import v2 task
$response = $client->deleteImportV2Task(
'activity-123'
);
print_r($response->getData());Response: DeleteImportV2TaskResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | - |
getImport
Obtains details about a specific data import, providing users with insights into the import’s configuration and status.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get import
$response = $client->getImport(
'activity-123'
);
print_r($response->getData());Response: GetImportResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | - |
getOG
Retrieves Open Graph data, which can be used to enhance the display of web content when shared on social media platforms.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get OG
$response = $client->getOG(
'value'
);
print_r($response->getData());Response: GetOGResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | - |
listPermissions
Lists all permissions available to a user or within a system, helping users understand their access rights and control over data and functionalities.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// List permissions
$response = $client->listPermissions();
print_r($response->getData());Response: ListPermissionsResponse
getPermission
Retrieve the permission settings for a specific user or entity, useful for checking access rights before performing operations.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get permission
$response = $client->getPermission(
'activity-123'
);
print_r($response->getData());Response: GetCustomPermissionResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | - |
createPoll
Initiate a new poll with specified parameters, ideal for gathering feedback or opinions from a group of users.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createPollRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create poll
$response = $client->createPoll(
new createPollRequest(
name: 'My Feed',
userID: 'john',
id: 'activity-123',
)
);
print_r($response->getData());Example: with allow_user_suggested_options and description
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createPollRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create poll
$response = $client->createPoll(
new createPollRequest(
name: 'My Feed',
allowUserSuggestedOptions: false,
description: 'A description',
)
);
print_r($response->getData());Example: with enforce_unique_vote and Custom
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createPollRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create poll
$response = $client->createPoll(
new createPollRequest(
name: 'My Feed',
enforceUniqueVote: false,
custom: {},
)
);
print_r($response->getData());Example: with is_closed and max_votes_allowed
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createPollRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create poll
$response = $client->createPoll(
new createPollRequest(
name: 'My Feed',
isClosed: false,
maxVotesAllowed: 10,
)
);
print_r($response->getData());Response: PollResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | The name of the poll |
| Custom | array | No | - |
| allow_answers | bool | No | Indicates whether users can suggest user defined answers |
| allow_user_suggested_options | bool | No | - |
| description | string | No | A description of the poll |
| enforce_unique_vote | bool | No | Indicates whether users can cast multiple votes |
| id | string | No | - |
| is_closed | bool | No | Indicates whether the poll is open for voting |
| max_votes_allowed | int | No | Indicates the maximum amount of votes a user can cast |
| options | []PollOptionInput | No | - |
| user | UserRequest | No | - |
| user_id | string | No | - |
| voting_visibility | string | No | - |
updatePoll
Modify an existing poll's details, such as its title or description, to keep it relevant and up-to-date.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updatePollRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update poll
$response = $client->updatePoll(
new updatePollRequest(
id: 'activity-123',
name: 'My Feed',
userID: 'john',
allowAnswers: false,
)
);
print_r($response->getData());Example: with allow_user_suggested_options and description
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updatePollRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update poll
$response = $client->updatePoll(
new updatePollRequest(
id: 'activity-123',
name: 'My Feed',
allowUserSuggestedOptions: false,
description: 'A description',
)
);
print_r($response->getData());Example: with enforce_unique_vote and is_closed
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updatePollRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update poll
$response = $client->updatePoll(
new updatePollRequest(
id: 'activity-123',
name: 'My Feed',
enforceUniqueVote: false,
isClosed: false,
)
);
print_r($response->getData());Example: with max_votes_allowed and options
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updatePollRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update poll
$response = $client->updatePoll(
new updatePollRequest(
id: 'activity-123',
name: 'My Feed',
maxVotesAllowed: 10,
options: [],
)
);
print_r($response->getData());Response: PollResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | Poll ID |
| name | string | Yes | Poll name |
| Custom | array | No | - |
| allow_answers | bool | No | Allow answers |
| allow_user_suggested_options | bool | No | Allow user suggested options |
| description | string | No | Poll description |
| enforce_unique_vote | bool | No | Enforce unique vote |
| is_closed | bool | No | Is closed |
| max_votes_allowed | int | No | Max votes allowed |
| options | []PollOptionRequest | No | Poll options |
| user | UserRequest | No | - |
| user_id | string | No | - |
| voting_visibility | string | No | Voting visibility |
queryPolls
Search and filter through existing polls based on specific criteria, helping you quickly find the polls of interest.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\queryPollsRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Query polls
$response = $client->queryPolls(
'john',
new queryPollsRequest(
limit: 25,
filter: {},
)
);
print_r($response->getData());Example: with sort and prev
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\queryPollsRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Query polls
$response = $client->queryPolls(
new queryPollsRequest(
sort: [],
prev: null,
)
);
print_r($response->getData());Example: with next
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\queryPollsRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Query polls
$response = $client->queryPolls(
new queryPollsRequest(
next: null,
)
);
print_r($response->getData());Response: QueryPollsResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | No | - |
| filter | array | No | Filter to apply to the query |
| limit | int | No | - |
| next | string | No | - |
| prev | string | No | - |
| sort | []SortParamRequest | No | Array of sort parameters |
getPoll
Access the details of a specific poll, essential for reviewing its content and status before engagement.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get poll
$response = $client->getPoll(
'poll-123',
'john'
);
print_r($response->getData());Response: PollResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| poll_id | string | Yes | - |
| user_id | string | No | - |
updatePollPartial
Make targeted updates to specific fields of a poll without altering its entire structure, useful for quick adjustments.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updatePollPartialRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Partial update poll
$response = $client->updatePollPartial(
'poll-123',
new updatePollPartialRequest(
userID: 'john',
unset: [],
)
);
print_r($response->getData());Example: with user and set
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updatePollPartialRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Partial update poll
$response = $client->updatePollPartial(
'poll-123',
new updatePollPartialRequest(
user: ['id' => 'activity-123', 'custom' => {}],
set: {},
)
);
print_r($response->getData());Response: PollResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| poll_id | string | Yes | - |
| set | array | No | Sets new field values |
| unset | []string | No | Array of field names to unset |
| user | UserRequest | No | - |
| user_id | string | No | - |
deletePoll
Remove a poll from the system, useful for maintaining a clean and relevant set of active polls.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete poll
$response = $client->deletePoll(
'poll-123',
'john'
);
print_r($response->getData());Response: Response
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| poll_id | string | Yes | - |
| user_id | string | No | - |
createPollOption
Add a new option to an existing poll, expanding the choices available to participants for more comprehensive feedback.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createPollOptionRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create poll option
$response = $client->createPollOption(
'poll-123',
new createPollOptionRequest(
text: 'Hello, world!',
userID: 'john',
user: ['id' => 'activity-123', 'custom' => {}],
)
);
print_r($response->getData());Example: with Custom
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createPollOptionRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create poll option
$response = $client->createPollOption(
'poll-123',
new createPollOptionRequest(
text: 'Hello, world!',
custom: {},
)
);
print_r($response->getData());Response: PollOptionResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| poll_id | string | Yes | - |
| text | string | Yes | Option text |
| Custom | array | No | - |
| user | UserRequest | No | - |
| user_id | string | No | - |
updatePollOption
Modify an existing poll option to correct or improve the available responses, ensuring clarity and accuracy.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updatePollOptionRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update poll option
$response = $client->updatePollOption(
'poll-123',
new updatePollOptionRequest(
id: 'activity-123',
text: 'Hello, world!',
userID: 'john',
user: ['id' => 'activity-123', 'custom' => {}],
)
);
print_r($response->getData());Example: with Custom
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updatePollOptionRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update poll option
$response = $client->updatePollOption(
'poll-123',
new updatePollOptionRequest(
id: 'activity-123',
text: 'Hello, world!',
custom: {},
)
);
print_r($response->getData());Response: PollOptionResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| poll_id | string | Yes | - |
| id | string | Yes | Option ID |
| text | string | Yes | Option text |
| Custom | array | No | - |
| user | UserRequest | No | - |
| user_id | string | No | - |
getPollOption
Retrieve details about a specific poll option, aiding in the analysis or review of available choices within a poll.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get poll option
$response = $client->getPollOption(
'poll-123',
'value',
'john'
);
print_r($response->getData());Response: PollOptionResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| poll_id | string | Yes | - |
| option_id | string | Yes | - |
| user_id | string | No | - |
deletePollOption
Remove a specific option from a poll, useful for managing and updating active polls by eliminating outdated or incorrect choices.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete poll option
$response = $client->deletePollOption(
'poll-123',
'value',
'john'
);
print_r($response->getData());Response: Response
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| poll_id | string | Yes | - |
| option_id | string | Yes | - |
| user_id | string | No | - |
queryPollVotes
Retrieve the current vote counts for a poll, enabling you to assess poll engagement and results in real-time.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\queryPollVotesRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Query votes
$response = $client->queryPollVotes(
'poll-123',
'john',
new queryPollVotesRequest(
limit: 25,
)
);
print_r($response->getData());Example: with filter and sort
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\queryPollVotesRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Query votes
$response = $client->queryPollVotes(
'poll-123',
new queryPollVotesRequest(
filter: {},
sort: [],
)
);
print_r($response->getData());Example: with prev and next
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\queryPollVotesRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Query votes
$response = $client->queryPollVotes(
'poll-123',
new queryPollVotesRequest(
prev: null,
next: null,
)
);
print_r($response->getData());Response: PollVotesResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| poll_id | string | Yes | - |
| user_id | string | No | - |
| filter | array | No | Filter to apply to the query |
| limit | int | No | - |
| next | string | No | - |
| prev | string | No | - |
| sort | []SortParamRequest | No | Array of sort parameters |
updatePushNotificationPreferences
Modify user preferences for receiving push notifications, ensuring users only receive relevant and desired notifications.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updatePushNotificationPreferencesRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Push notification preferences
$response = $client->updatePushNotificationPreferences(
new updatePushNotificationPreferencesRequest(
preferences: [],
)
);
print_r($response->getData());Response: UpsertPushPreferencesResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| preferences | []PushPreferenceInput | Yes | A list of push preferences for channels, calls, or the user. |
listPushProviders
Obtain a list of all available push notification providers, helpful for understanding your options and managing your notification delivery services.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// List push providers
$response = $client->listPushProviders();
print_r($response->getData());Response: ListPushProvidersResponse
upsertPushProvider
Create or update the configuration of a push notification provider, allowing you to maintain an effective notification system by adding new providers or adjusting existing ones.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\upsertPushProviderRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Upsert a push provider
$response = $client->upsertPushProvider(
new upsertPushProviderRequest(
pushProvider: ['name' => 'My Feed', 'apn_auth_key' => 'value'],
)
);
print_r($response->getData());Response: UpsertPushProviderResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| push_provider | PushProviderRequest | No | - |
deletePushProvider
Remove a push notification provider from your system, ideal for cleaning up outdated configurations or switching to a different service provider.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete a push provider
$response = $client->deletePushProvider(
'like',
'My Feed'
);
print_r($response->getData());Response: Response
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| type | string | Yes | - |
| name | string | Yes | - |
getPushTemplates
Access a collection of predefined push notification templates, streamlining the process of sending consistent and branded notifications to your users.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get push notification templates
$response = $client->getPushTemplates(
'value',
'value'
);
print_r($response->getData());Response: GetPushTemplatesResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| push_provider_type | string | Yes | - |
| push_provider_name | string | No | - |
upsertPushTemplate
Create or update a push notification template, enabling you to maintain up-to-date and relevant messaging for your user communications.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\upsertPushTemplateRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Upsert a push notification template
$response = $client->upsertPushTemplate(
new upsertPushTemplateRequest(
eventType: 'value',
pushProviderType: 'value',
enablePush: false,
pushProviderName: 'value',
)
);
print_r($response->getData());Example: with template
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\upsertPushTemplateRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Upsert a push notification template
$response = $client->upsertPushTemplate(
new upsertPushTemplateRequest(
eventType: 'value',
pushProviderType: 'value',
template: 'value',
)
);
print_r($response->getData());Response: UpsertPushTemplateResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| event_type | string | Yes | Event type. One of: message.new, message.updated, reaction.new, notification.reminder_due, feeds.... |
| push_provider_type | string | Yes | Push provider type. One of: firebase, apn, huawei, xiaomi |
| enable_push | bool | No | Whether to send push notification for this event |
| push_provider_name | string | No | Push provider name |
| template | string | No | Push template |
getRateLimits
Retrieve the current rate limits applied to your API usage, helping you understand and manage your application's request throughput.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get rate limits
$response = $client->getRateLimits(
false,
false,
false
);
print_r($response->getData());Example: with web and endpoints
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get rate limits
$response = $client->getRateLimits(
false,
'value'
);
print_r($response->getData());Response: GetRateLimitsResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| server_side | bool | No | - |
| android | bool | No | - |
| ios | bool | No | - |
| web | bool | No | - |
| endpoints | string | No | - |
listRoles
Get a comprehensive list of all defined user roles within your application, useful for managing permissions and access control effectively.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// List roles
$response = $client->listRoles();
print_r($response->getData());Response: ListRolesResponse
createRole
Create a new role within the system to define specific permissions and access levels for users. Use this method to manage and assign roles that align with your organizational needs.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createRoleRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create role
$response = $client->createRole(
new createRoleRequest(
name: 'My Feed',
)
);
print_r($response->getData());Response: CreateRoleResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | Role name |
deleteRole
Remove an existing role from the system to maintain an updated and efficient role management structure. Use this method when a role is no longer needed or applicable.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete role
$response = $client->deleteRole(
'My Feed'
);
print_r($response->getData());Response: Response
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | - |
getTask
Retrieve the current status and progress of a specific task to monitor its completion and identify potential issues. Use this method to track task performance and ensure timely updates.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get status of a task
$response = $client->getTask(
'activity-123'
);
print_r($response->getData());Response: GetTaskResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | - |
uploadFile
Add a file to the server to facilitate storage and access within your application. Use this method to manage file resources and enhance document availability for users.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\uploadFileRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Upload file
$response = $client->uploadFile(
new uploadFileRequest(
file: 'value',
user: ['id' => 'activity-123'],
)
);
print_r($response->getData());Response: FileUploadResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| file | string | No | file field |
| user | OnlyUserID | No | user for the request server side only |
deleteFile
Remove a file from the server to manage storage and ensure only relevant files are retained. Use this method to free up space and maintain an organized file system.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete file
$response = $client->deleteFile(
'value'
);
print_r($response->getData());Response: Response
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | No | - |
uploadImage
Upload an image to the server for integration into your application’s content. Use this method to manage visual assets and improve the aesthetic and functional aspects of your application.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\uploadImageRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Upload image
$response = $client->uploadImage(
new uploadImageRequest(
file: 'value',
uploadSizes: [],
user: ['id' => 'activity-123'],
)
);
print_r($response->getData());Response: ImageUploadResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| file | string | No | - |
| upload_sizes | []ImageSize | No | field with JSON-encoded array of image size configurations |
| user | OnlyUserID | No | - |
deleteImage
Delete an image from the server to manage space and ensure only necessary images are stored. Use this method when an image is outdated or no longer required.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete image
$response = $client->deleteImage(
'value'
);
print_r($response->getData());Response: Response
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | No | - |
listUserGroups
Retrieve a list of all user groups. Use this method to view all existing user groups in your system for management or auditing purposes.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// List user groups
$response = $client->listUserGroups(
25,
'value',
'value'
);
print_r($response->getData());Example: with team_id
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// List user groups
$response = $client->listUserGroups(
'value'
);
print_r($response->getData());Response: ListUserGroupsResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | int | No | - |
| id_gt | string | No | - |
| created_at_gt | string | No | - |
| team_id | string | No | - |
createUserGroup
Establish a new user group. Use this method to organize users into a new group for easier management and permissions assignment.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createUserGroupRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create user group
$response = $client->createUserGroup(
new createUserGroupRequest(
name: 'My Feed',
id: 'activity-123',
description: 'A description',
)
);
print_r($response->getData());Example: with member_ids and team_id
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\createUserGroupRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Create user group
$response = $client->createUserGroup(
new createUserGroupRequest(
name: 'My Feed',
memberIds: [],
teamID: 'value',
)
);
print_r($response->getData());Response: CreateUserGroupResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | The user friendly name of the user group |
| description | string | No | An optional description for the group |
| id | string | No | Optional user group ID. If not provided, a UUID v7 will be generated |
| member_ids | []string | No | Optional initial list of user IDs to add as members |
| team_id | string | No | Optional team ID to scope the group to a team |
searchUserGroups
Find user groups based on specific criteria. Use this method to quickly locate user groups that meet certain conditions or attributes.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Search user groups
$response = $client->searchUserGroups(
'value',
25,
'value'
);
print_r($response->getData());Example: with id_gt and team_id
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Search user groups
$response = $client->searchUserGroups(
'value',
'value',
'value'
);
print_r($response->getData());Response: SearchUserGroupsResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | - |
| limit | int | No | - |
| name_gt | string | No | - |
| id_gt | string | No | - |
| team_id | string | No | - |
getUserGroup
Obtain detailed information about a specific user group. Use this method to review the properties and configuration of a particular user group.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get user group
$response = $client->getUserGroup(
'activity-123',
'value'
);
print_r($response->getData());Response: GetUserGroupResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | - |
| team_id | string | No | - |
updateUserGroup
Modify the details of an existing user group. Use this method to change the attributes or membership of a user group as needed.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updateUserGroupRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update user group
$response = $client->updateUserGroup(
'activity-123',
new updateUserGroupRequest(
name: 'My Feed',
description: 'A description',
)
);
print_r($response->getData());Example: with team_id
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updateUserGroupRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update user group
$response = $client->updateUserGroup(
'activity-123',
new updateUserGroupRequest(
teamID: 'value',
)
);
print_r($response->getData());Response: UpdateUserGroupResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | - |
| description | string | No | The new description for the group |
| name | string | No | The new name of the user group |
| team_id | string | No | - |
deleteUserGroup
Remove a user group from the system. Use this method when a user group is no longer needed, to maintain cleanliness and organization.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete user group
$response = $client->deleteUserGroup(
'activity-123',
'value'
);
print_r($response->getData());Response: Response
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | - |
| team_id | string | No | - |
addUserGroupMembers
Use this method to add multiple users to a specified user group, streamlining group management and access control. Ideal for onboarding new team members or updating group memberships efficiently.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\addUserGroupMembersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Add user group members
$response = $client->addUserGroupMembers(
'activity-123',
new addUserGroupMembersRequest(
memberIds: [],
asAdmin: false,
teamID: 'value',
)
);
print_r($response->getData());Response: AddUserGroupMembersResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | - |
| member_ids | []string | Yes | List of user IDs to add as members |
| as_admin | bool | No | Whether to add the members as group admins. Defaults to false |
| team_id | string | No | - |
removeUserGroupMembers
This method allows you to remove multiple users from a specified user group, helping to maintain organized and current access permissions. It is useful for managing group changes when users no longer need access or have left a team.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\removeUserGroupMembersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Remove user group members
$response = $client->removeUserGroupMembers(
'activity-123',
new removeUserGroupMembersRequest(
memberIds: [],
teamID: 'value',
)
);
print_r($response->getData());Response: RemoveUserGroupMembersResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | - |
| member_ids | []string | Yes | List of user IDs to remove |
| team_id | string | No | - |
queryUsers
Retrieve information about users based on specific criteria to analyze user data or make informed decisions. Use this method to efficiently filter and access user details in your application.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Query users
$response = $client->queryUsers(
'value'
);
print_r($response->getData());Response: QueryUsersResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| payload | No | - |
updateUsers
Add or modify user information to ensure current and accurate user data within the system. Use this method to manage user profiles effectively and support proper user engagement.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updateUsersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Upsert users
$response = $client->updateUsers(
new updateUsersRequest(
users: {},
)
);
print_r($response->getData());Response: UpdateUsersResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| users | array | Yes | Object containing users |
updateUsersPartial
Apply partial updates to a user's information, allowing for specific changes without overwriting the entire user profile. Use this method for targeted updates to user data, enhancing flexibility and precision.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updateUsersPartialRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Partially update user
$response = $client->updateUsersPartial(
new updateUsersPartialRequest(
users: [],
)
);
print_r($response->getData());Response: UpdateUsersResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| users | []UpdateUserPartialRequest | Yes | - |
getBlockedUsers
Retrieve a list of users that have been blocked. Use this method to monitor and manage users who are restricted from accessing certain features or areas of your application.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get list of blocked Users
$response = $client->getBlockedUsers(
'john'
);
print_r($response->getData());Response: GetBlockedUsersResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | No | - |
blockUsers
Prevent specified users from accessing certain features or areas of your application. This method is useful for managing user behavior and maintaining community standards.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\blockUsersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Block user
$response = $client->blockUsers(
new blockUsersRequest(
blockedUserID: 'value',
userID: 'john',
user: ['id' => 'activity-123', 'custom' => {}],
)
);
print_r($response->getData());Response: BlockUsersResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| blocked_user_id | string | Yes | User id to block |
| user | UserRequest | No | - |
| user_id | string | No | - |
deactivateUsers
Temporarily disable the accounts of specified users, making them inactive. Use this when you need to pause a user's access without permanently deleting their data.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\deactivateUsersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Deactivate users
$response = $client->deactivateUsers(
new deactivateUsersRequest(
userIds: ['user-1', 'user-2'],
createdByID: 'value',
markChannelsDeleted: false,
)
);
print_r($response->getData());Example: with mark_messages_deleted
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\deactivateUsersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Deactivate users
$response = $client->deactivateUsers(
new deactivateUsersRequest(
userIds: ['user-1', 'user-2'],
markMessagesDeleted: false,
)
);
print_r($response->getData());Response: DeactivateUsersResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_ids | []string | Yes | User IDs to deactivate |
| created_by_id | string | No | ID of the user who deactivated the users |
| mark_channels_deleted | bool | No | - |
| mark_messages_deleted | bool | No | Makes messages appear to be deleted |
deleteUsers
Permanently remove users and all their associated data from your application. Use this method for irreversible actions when you need to completely eliminate a user's presence.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\deleteUsersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete Users
$response = $client->deleteUsers(
new deleteUsersRequest(
userIds: ['user-1', 'user-2'],
calls: 'value',
conversations: 'value',
)
);
print_r($response->getData());Example: with files and messages
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\deleteUsersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete Users
$response = $client->deleteUsers(
new deleteUsersRequest(
userIds: ['user-1', 'user-2'],
files: false,
messages: 'value',
)
);
print_r($response->getData());Example: with new_call_owner_id and new_channel_owner_id
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\deleteUsersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete Users
$response = $client->deleteUsers(
new deleteUsersRequest(
userIds: ['user-1', 'user-2'],
newCallOwnerID: 'value',
newChannelOwnerID: 'value',
)
);
print_r($response->getData());Example: with user
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\deleteUsersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Delete Users
$response = $client->deleteUsers(
new deleteUsersRequest(
userIds: ['user-1', 'user-2'],
user: { id: "john" },
)
);
print_r($response->getData());Response: DeleteUsersResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_ids | []string | Yes | IDs of users to delete |
| calls | string | No | Calls delete mode. Affected calls are those that include exactly two members, one of whom is the ... |
| conversations | string | No | Conversation channels delete mode. Conversation channel is any channel which only has two members... |
| files | bool | No | Delete user files. * false or empty string - doesn't delete any files * true - deletes all files ... |
| messages | string | No | Message delete mode. * null or empty string - doesn't delete user messages * soft - marks all use... |
| new_call_owner_id | string | No | - |
| new_channel_owner_id | string | No | - |
| user | string | No | User delete mode. * soft - marks user as deleted and retains all user data * pruning - marks user... |
getUserLiveLocations
Fetch the current live location data of users. This is useful in applications where real-time location tracking is necessary, such as delivery or ride-sharing services.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Get user live locations
$response = $client->getUserLiveLocations(
'john'
);
print_r($response->getData());Response: SharedLocationsResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | No | - |
updateLiveLocation
Update the live location data for a user. Use this method to ensure that your application has the most current and accurate location information for users.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updateLiveLocationRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update live location
$response = $client->updateLiveLocation(
'john',
new updateLiveLocationRequest(
messageID: 'value',
endAt: 10,
)
);
print_r($response->getData());Example: with latitude and longitude
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\updateLiveLocationRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Update live location
$response = $client->updateLiveLocation(
new updateLiveLocationRequest(
messageID: 'value',
latitude: 10,
longitude: 10,
)
);
print_r($response->getData());Response: SharedLocationResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| message_id | string | Yes | Live location ID |
| user_id | string | No | - |
| end_at | float | No | Time when the live location expires |
| latitude | float | No | Latitude coordinate |
| longitude | float | No | Longitude coordinate |
reactivateUsers
Reactivate previously deactivated user accounts, restoring their access to the application. Use this method to reinstate users who were temporarily paused.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\reactivateUsersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Reactivate users
$response = $client->reactivateUsers(
new reactivateUsersRequest(
userIds: ['user-1', 'user-2'],
createdByID: 'value',
restoreChannels: false,
)
);
print_r($response->getData());Example: with restore_messages
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\reactivateUsersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Reactivate users
$response = $client->reactivateUsers(
new reactivateUsersRequest(
userIds: ['user-1', 'user-2'],
restoreMessages: false,
)
);
print_r($response->getData());Response: ReactivateUsersResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_ids | []string | Yes | User IDs to reactivate |
| created_by_id | string | No | ID of the user who's reactivating the users |
| restore_channels | bool | No | - |
| restore_messages | bool | No | Restore previously deleted messages |
restoreUsers
Restore users and their data after they have been deleted, if you have a recovery mechanism in place. This is useful for recovering mistakenly deleted user accounts.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\restoreUsersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Restore users
$response = $client->restoreUsers(
new restoreUsersRequest(
userIds: ['user-1', 'user-2'],
)
);
print_r($response->getData());Response: Response
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_ids | []string | Yes | - |
unblockUsers
Remove the block on specified users, allowing them to regain access to previously restricted features or areas. Use this to reverse previous blocking actions when a user is deemed compliant.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\unblockUsersRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Unblock user
$response = $client->unblockUsers(
new unblockUsersRequest(
blockedUserID: 'value',
userID: 'john',
user: ['id' => 'activity-123', 'custom' => {}],
)
);
print_r($response->getData());Response: UnblockUsersResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| blocked_user_id | string | Yes | - |
| user | UserRequest | No | - |
| user_id | string | No | - |
deactivateUser
Temporarily deactivate a single user account, suspending their access. Use this when you need to pause an individual user's account without deleting their data.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\deactivateUserRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Deactivate user
$response = $client->deactivateUser(
'john',
new deactivateUserRequest(
createdByID: 'value',
markMessagesDeleted: false,
)
);
print_r($response->getData());Response: DeactivateUserResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | Yes | - |
| created_by_id | string | No | ID of the user who deactivated the user |
| mark_messages_deleted | bool | No | Makes messages appear to be deleted |
exportUser
ExportUser allows you to retrieve all data associated with a specific user in a structured format, which is useful for data analysis, migration, or compliance purposes.
Example
<?php
use GetStream\ClientBuilder;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Export user
$response = $client->exportUser(
'john'
);
print_r($response->getData());Response: ExportUserResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | Yes | - |
reactivateUser
ReactivateUser enables you to restore a previously deactivated user account, making it active again, which is beneficial for reinstating user access after temporary deactivation.
Example
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\reactivateUserRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Reactivate user
$response = $client->reactivateUser(
'john',
new reactivateUserRequest(
name: 'My Feed',
createdByID: 'value',
)
);
print_r($response->getData());Example: with restore_messages
<?php
use GetStream\ClientBuilder;
use GetStream\GeneratedModels\reactivateUserRequest;
$client = ClientBuilder::fromEnv()->buildFeedsClient();
// Or with explicit credentials:
// $client = (new ClientBuilder())
// ->apiKey($apiKey)
// ->apiSecret($apiSecret)
// ->buildFeedsClient();
// Reactivate user
$response = $client->reactivateUser(
'john',
new reactivateUserRequest(
restoreMessages: false,
)
);
print_r($response->getData());Response: ReactivateUserResponse
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| user_id | string | Yes | - |
| created_by_id | string | No | ID of the user who's reactivating the user |
| name | string | No | Set this field to put new name for the user |
| restore_messages | bool | No | Restore previously deleted messages |
Types Reference
This section documents the types/interfaces used in this API. These types are extracted from the OpenAPI specification.
AIImageConfig
// AIImageConfig array structure
[
'async' => bool, //
'enabled' => bool, //
'ocr_rules' => array, //
'rules' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| async | bool | No | |
| enabled | bool | No | |
| ocr_rules | array | No | |
| rules | array | No |
AITextConfig
// AITextConfig array structure
[
'async' => bool, //
'enabled' => bool, //
'profile' => string, //
'rules' => array, //
'severity_rules' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| async | bool | No | |
| enabled | bool | No | |
| profile | string | No | |
| rules | array | No | |
| severity_rules | array | No |
AIVideoConfig
// AIVideoConfig array structure
[
'async' => bool, //
'enabled' => bool, //
'rules' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| async | bool | No | |
| enabled | bool | No | |
| rules | array | No |
APNConfig
// APNConfig array structure
[
'Disabled' => bool, //
'auth_key' => string, //
'auth_type' => string, //
'bundle_id' => string, //
'development' => bool, //
'host' => string, //
'key_id' => string, //
'notification_template' => string, //
'p12_cert' => string, //
'team_id' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| Disabled | bool | No | |
| auth_key | string | No | |
| auth_type | string | No | |
| bundle_id | string | No | |
| development | bool | No | |
| host | string | No | |
| key_id | string | No | |
| notification_template | string | No | |
| p12_cert | string | No | |
| team_id | string | No |
Action
// Action array structure
[
'name' => string, //
'style' => string, //
'text' => string, //
'type' => string, //
'value' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | |
| text | string | Yes | |
| type | string | Yes | |
| style | string | No | |
| value | string | No |
AddUserGroupMembersResponse
Response for adding members to a user group
// AddUserGroupMembersResponse array structure
[
'duration' => string, //
'user_group' => UserGroupResponse, // The updated user group
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | |
| user_group | UserGroupResponse | No | The updated user group |
AppResponseFields
// AppResponseFields array structure
[
'activity_metrics_config' => array, //
'allow_multi_user_devices' => bool, //
'allowed_flag_reasons' => array, //
'async_url_enrich_enabled' => bool, //
'auto_translation_enabled' => bool, //
'before_message_send_hook_url' => string, //
'call_types' => array, //
'campaign_enabled' => bool, //
'cdn_expiration_seconds' => int, //
'channel_configs' => array, //
'custom_action_handler_url' => string, //
'datadog_info' => DataDogInfo, //
'disable_auth_checks' => bool, //
'disable_permissions_checks' => bool, //
'enforce_unique_usernames' => string, //
'event_hooks' => array, //
'file_upload_config' => FileUploadConfig, //
'geofences' => array, //
'grants' => array, //
'guest_user_creation_disabled' => bool, //
'id' => int, //
'image_moderation_enabled' => bool, //
'image_moderation_labels' => array, //
'image_upload_config' => FileUploadConfig, //
'max_aggregated_activities_length' => int, //
'moderation_audio_call_moderation_enabled' => bool, //
'moderation_dashboard_preferences' => ModerationDashboardPreferences, //
'moderation_enabled' => bool, //
'moderation_llm_configurability_enabled' => bool, //
'moderation_multitenant_blocklist_enabled' => bool, //
'moderation_s3_image_access_role_arn' => string, //
'moderation_video_call_moderation_enabled' => bool, //
'moderation_webhook_url' => string, //
'multi_tenant_enabled' => bool, //
'name' => string, //
'organization' => string, //
'permission_version' => string, //
'placement' => string, //
'policies' => array, //
'push_notifications' => PushNotificationFields, //
'reminders_interval' => int, //
'revoke_tokens_issued_before' => float, //
'sns_key' => string, //
'sns_secret' => string, //
'sns_topic_arn' => string, //
'sqs_key' => string, //
'sqs_secret' => string, //
'sqs_url' => string, //
'suspended' => bool, //
'suspended_explanation' => string, //
'use_hook_v2' => bool, //
'user_response_time_enabled' => bool, //
'user_search_disallowed_roles' => array, //
'webhook_events' => array, //
'webhook_url' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| allow_multi_user_devices | bool | Yes | |
| async_url_enrich_enabled | bool | Yes | |
| auto_translation_enabled | bool | Yes | |
| call_types | array | Yes | |
| campaign_enabled | bool | Yes | |
| cdn_expiration_seconds | int | Yes | |
| channel_configs | array | Yes | |
| custom_action_handler_url | string | Yes | |
| disable_auth_checks | bool | Yes | |
| disable_permissions_checks | bool | Yes | |
| enforce_unique_usernames | string | Yes | |
| event_hooks | array | Yes | |
| file_upload_config | FileUploadConfig | Yes | |
| grants | array | Yes | |
| guest_user_creation_disabled | bool | Yes | |
| id | int | Yes | |
| image_moderation_enabled | bool | Yes | |
| image_upload_config | FileUploadConfig | Yes | |
| max_aggregated_activities_length | int | Yes | |
| moderation_audio_call_moderation_enabled | bool | Yes | |
| moderation_enabled | bool | Yes | |
| moderation_llm_configurability_enabled | bool | Yes | |
| moderation_multitenant_blocklist_enabled | bool | Yes | |
| moderation_video_call_moderation_enabled | bool | Yes | |
| moderation_webhook_url | string | Yes | |
| multi_tenant_enabled | bool | Yes | |
| name | string | Yes | |
| organization | string | Yes | |
| permission_version | string | Yes | |
| placement | string | Yes | |
| policies | array | Yes | |
| push_notifications | PushNotificationFields | Yes | |
| reminders_interval | int | Yes | |
| sns_key | string | Yes | |
| sns_secret | string | Yes | |
| sns_topic_arn | string | Yes | |
| sqs_key | string | Yes | |
| sqs_secret | string | Yes | |
| sqs_url | string | Yes | |
| suspended | bool | Yes | |
| suspended_explanation | string | Yes | |
| use_hook_v2 | bool | Yes | |
| user_response_time_enabled | bool | Yes | |
| user_search_disallowed_roles | array | Yes | |
| webhook_events | array | Yes | |
| webhook_url | string | Yes | |
| activity_metrics_config | array | No | |
| allowed_flag_reasons | array | No | |
| before_message_send_hook_url | string | No | |
| datadog_info | DataDogInfo | No | |
| geofences | array | No | |
| image_moderation_labels | array | No | |
| moderation_dashboard_preferences | ModerationDashboardPreferences | No | |
| moderation_s3_image_access_role_arn | string | No | |
| revoke_tokens_issued_before | float | No |
AsyncModerationCallbackConfig
// AsyncModerationCallbackConfig array structure
[
'mode' => string, //
'server_url' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| mode | string | No | |
| server_url | string | No |
AsyncModerationConfiguration
// AsyncModerationConfiguration array structure
[
'callback' => AsyncModerationCallbackConfig, //
'timeout_ms' => int, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| callback | AsyncModerationCallbackConfig | No | |
| timeout_ms | int | No |
AutomodPlatformCircumventionConfig
// AutomodPlatformCircumventionConfig array structure
[
'async' => bool, //
'enabled' => bool, //
'rules' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| async | bool | No | |
| enabled | bool | No | |
| rules | array | No |
AutomodSemanticFiltersConfig
// AutomodSemanticFiltersConfig array structure
[
'async' => bool, //
'enabled' => bool, //
'rules' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| async | bool | No | |
| enabled | bool | No | |
| rules | array | No |
AutomodToxicityConfig
// AutomodToxicityConfig array structure
[
'async' => bool, //
'enabled' => bool, //
'rules' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| async | bool | No | |
| enabled | bool | No | |
| rules | array | No |
AzureRequest
Config for creating Azure Blob Storage storage
// AzureRequest array structure
[
'abs_account_name' => string, // The account name
'abs_client_id' => string, // The client id
'abs_client_secret' => string, // The client secret
'abs_tenant_id' => string, // The tenant id
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| abs_account_name | string | Yes | The account name |
| abs_client_id | string | Yes | The client id |
| abs_client_secret | string | Yes | The client secret |
| abs_tenant_id | string | Yes | The tenant id |
BlockListConfig
// BlockListConfig array structure
[
'async' => bool, //
'enabled' => bool, //
'match_substring' => bool, //
'rules' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| async | bool | No | |
| enabled | bool | No | |
| match_substring | bool | No | |
| rules | array | No |
BlockListResponse
Block list contains restricted words
// BlockListResponse array structure
[
'created_at' => float, // Date/time of creation
'id' => string, //
'is_leet_check_enabled' => bool, //
'is_plural_check_enabled' => bool, //
'name' => string, // Block list name
'team' => string, //
'type' => string, // Block list type. One of: regex, domain, domain_allowlist, email, email_allowlist, word
'updated_at' => float, // Date/time of the last update
'words' => array, // List of words to block
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| is_leet_check_enabled | bool | Yes | |
| is_plural_check_enabled | bool | Yes | |
| name | string | Yes | Block list name |
| type | string | Yes | Block list type. One of: regex, domain, domain_allowlist, email, email_allowl... |
| words | array | Yes | List of words to block |
| created_at | float | No | Date/time of creation |
| id | string | No | |
| team | string | No | |
| updated_at | float | No | Date/time of the last update |
BlockUsersResponse
// BlockUsersResponse array structure
[
'blocked_by_user_id' => string, // User id who blocked another user
'blocked_user_id' => string, // User id who got blocked
'created_at' => float, // Timestamp when the user was blocked
'duration' => string, // Duration of the request in milliseconds
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| blocked_by_user_id | string | Yes | User id who blocked another user |
| blocked_user_id | string | Yes | User id who got blocked |
| created_at | float | Yes | Timestamp when the user was blocked |
| duration | string | Yes | Duration of the request in milliseconds |
BlockedUserResponse
// BlockedUserResponse array structure
[
'blocked_user' => UserResponse, // User who got blocked
'blocked_user_id' => string, // ID of the user who got blocked
'created_at' => float, //
'user' => UserResponse, // User who blocked another user
'user_id' => string, // ID of the user who blocked another user
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| blocked_user | UserResponse | Yes | User who got blocked |
| blocked_user_id | string | Yes | ID of the user who got blocked |
| created_at | float | Yes | |
| user | UserResponse | Yes | User who blocked another user |
| user_id | string | Yes | ID of the user who blocked another user |
BodyguardImageAnalysisConfig
// BodyguardImageAnalysisConfig array structure
[
'rules' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| rules | array | No |
ChannelResponse
Represents channel in chat
// ChannelResponse array structure
[
'auto_translation_enabled' => bool, // Whether auto translation is enabled or not
'auto_translation_language' => string, // Language to translate to when auto translation is active
'blocked' => bool, // Whether this channel is blocked by current user or not
'cid' => string, // Channel CID (<type>:<id>)
'config' => ChannelConfigWithInfo, // Channel configuration
'cooldown' => int, // Cooldown period after sending each message
'created_at' => float, // Date/time of creation
'created_by' => UserResponse, // Creator of the channel
'custom' => array, // Custom data for this object
'deleted_at' => float, // Date/time of deletion
'disabled' => bool, //
'filter_tags' => array, // List of filter tags associated with the channel
'frozen' => bool, // Whether channel is frozen or not
'hidden' => bool, // Whether this channel is hidden by current user or not
'hide_messages_before' => float, // Date since when the message history is accessible
'id' => string, // Channel unique ID
'last_message_at' => float, // Date of the last message sent
'member_count' => int, // Number of members in the channel
'members' => array, // List of channel members (max 100)
'message_count' => int, // Number of messages in the channel
'mute_expires_at' => float, // Date of mute expiration
'muted' => bool, // Whether this channel is muted or not
'own_capabilities' => array, // List of channel capabilities of authenticated user
'team' => string, // Team the channel belongs to (multi-tenant only)
'truncated_at' => float, // Date of the latest truncation of the channel
'truncated_by' => UserResponse, //
'type' => string, // Type of the channel
'updated_at' => float, // Date/time of the last update
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| cid | string | Yes | Channel CID (<type>:<id>) |
| created_at | float | Yes | Date/time of creation |
| custom | array | Yes | Custom data for this object |
| disabled | bool | Yes | |
| frozen | bool | Yes | Whether channel is frozen or not |
| id | string | Yes | Channel unique ID |
| type | string | Yes | Type of the channel |
| updated_at | float | Yes | Date/time of the last update |
| auto_translation_enabled | bool | No | Whether auto translation is enabled or not |
| auto_translation_language | string | No | Language to translate to when auto translation is active |
| blocked | bool | No | Whether this channel is blocked by current user or not |
| config | ChannelConfigWithInfo | No | Channel configuration |
| cooldown | int | No | Cooldown period after sending each message |
| created_by | UserResponse | No | Creator of the channel |
| deleted_at | float | No | Date/time of deletion |
| filter_tags | array | No | List of filter tags associated with the channel |
| hidden | bool | No | Whether this channel is hidden by current user or not |
| hide_messages_before | float | No | Date since when the message history is accessible |
| last_message_at | float | No | Date of the last message sent |
| member_count | int | No | Number of members in the channel |
| members | array | No | List of channel members (max 100) |
| message_count | int | No | Number of messages in the channel |
| mute_expires_at | float | No | Date of mute expiration |
| muted | bool | No | Whether this channel is muted or not |
| own_capabilities | array | No | List of channel capabilities of authenticated user |
| team | string | No | Team the channel belongs to (multi-tenant only) |
| truncated_at | float | No | Date of the latest truncation of the channel |
| truncated_by | UserResponse | No |
ChatPreferencesInput
// ChatPreferencesInput array structure
[
'channel_mentions' => string, //
'default_preference' => string, //
'direct_mentions' => string, //
'group_mentions' => string, //
'here_mentions' => string, //
'role_mentions' => string, //
'thread_replies' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| channel_mentions | string | No | |
| default_preference | string | No | |
| direct_mentions | string | No | |
| group_mentions | string | No | |
| here_mentions | string | No | |
| role_mentions | string | No | |
| thread_replies | string | No |
CheckExternalStorageResponse
Basic response information
// CheckExternalStorageResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'file_url' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| file_url | string | Yes |
CheckPushResponse
// CheckPushResponse array structure
[
'device_errors' => array, // Object with device errors
'duration' => string, //
'event_type' => string, // The event type that was tested
'general_errors' => array, // List of general errors
'rendered_apn_template' => string, //
'rendered_firebase_template' => string, //
'rendered_message' => array, //
'skip_devices' => bool, // Don't require existing devices to render templates
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | |
| device_errors | array | No | Object with device errors |
| event_type | string | No | The event type that was tested |
| general_errors | array | No | List of general errors |
| rendered_apn_template | string | No | |
| rendered_firebase_template | string | No | |
| rendered_message | array | No | |
| skip_devices | bool | No | Don't require existing devices to render templates |
CheckSNSResponse
// CheckSNSResponse array structure
[
'data' => array, // Error data
'duration' => string, //
'error' => string, // Error text
'status' => string, // Validation result. One of: ok, error
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | |
| status | string | Yes | Validation result. One of: ok, error |
| data | array | No | Error data |
| error | string | No | Error text |
CheckSQSResponse
// CheckSQSResponse array structure
[
'data' => array, // Error data
'duration' => string, //
'error' => string, // Error text
'status' => string, // Validation result. One of: ok, error
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | |
| status | string | Yes | Validation result. One of: ok, error |
| data | array | No | Error data |
| error | string | No | Error text |
CreateBlockListResponse
Basic response information
// CreateBlockListResponse array structure
[
'blocklist' => BlockListResponse, //
'duration' => string, // Duration of the request in milliseconds
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| blocklist | BlockListResponse | No |
CreateExternalStorageResponse
Basic response information
// CreateExternalStorageResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
CreateGuestResponse
// CreateGuestResponse array structure
[
'access_token' => string, // the access token to authenticate the user
'duration' => string, // Duration of the request in milliseconds
'user' => UserResponse, // User object which server acts upon
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| access_token | string | Yes | the access token to authenticate the user |
| duration | string | Yes | Duration of the request in milliseconds |
| user | UserResponse | Yes | User object which server acts upon |
CreateImportResponse
Basic response information
// CreateImportResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'import_task' => ImportTask, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| import_task | ImportTask | No |
CreateImportURLResponse
Basic response information
// CreateImportURLResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'path' => string, //
'upload_url' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| path | string | Yes | |
| upload_url | string | Yes |
CreateImportV2TaskResponse
Basic response information
// CreateImportV2TaskResponse array structure
[
'app_pk' => int, //
'created_at' => float, //
'duration' => string, // Duration of the request in milliseconds
'id' => string, //
'product' => string, //
'settings' => ImportV2TaskSettings, //
'state' => int, //
'updated_at' => float, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| app_pk | int | Yes | |
| created_at | float | Yes | |
| duration | string | Yes | Duration of the request in milliseconds |
| id | string | Yes | |
| product | string | Yes | |
| settings | ImportV2TaskSettings | Yes | |
| state | int | Yes | |
| updated_at | float | Yes |
CreateRoleResponse
Basic response information
// CreateRoleResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'role' => Role, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| role | Role | Yes |
CreateUserGroupResponse
Response for creating a user group
// CreateUserGroupResponse array structure
[
'duration' => string, //
'user_group' => UserGroupResponse, // The created user group
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | |
| user_group | UserGroupResponse | No | The created user group |
Data
// Data array structure
[
'id' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| id | string | Yes |
DataDogInfo
// DataDogInfo array structure
[
'api_key' => string, //
'enabled' => bool, //
'site' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| api_key | string | No | |
| enabled | bool | No | |
| site | string | No |
DeactivateUserResponse
// DeactivateUserResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'user' => UserResponse, // Deactivated user object
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| user | UserResponse | No | Deactivated user object |
DeactivateUsersResponse
Basic response information
// DeactivateUsersResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'task_id' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| task_id | string | Yes |
DeleteExternalStorageResponse
Basic response information
// DeleteExternalStorageResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
DeleteImportV2TaskResponse
Basic response information
// DeleteImportV2TaskResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
DeleteUsersResponse
// DeleteUsersResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'task_id' => string, // ID of the task to delete users
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| task_id | string | Yes | ID of the task to delete users |
DeviceResponse
Response for Device
// DeviceResponse array structure
[
'created_at' => float, // Date/time of creation
'disabled' => bool, // Whether device is disabled or not
'disabled_reason' => string, // Reason explaining why device had been disabled
'id' => string, // Device ID
'push_provider' => string, // Push provider
'push_provider_name' => string, // Push provider name
'user_id' => string, // User ID
'voip' => bool, // When true the token is for Apple VoIP push notifications
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| created_at | float | Yes | Date/time of creation |
| id | string | Yes | Device ID |
| push_provider | string | Yes | Push provider |
| user_id | string | Yes | User ID |
| disabled | bool | No | Whether device is disabled or not |
| disabled_reason | string | No | Reason explaining why device had been disabled |
| push_provider_name | string | No | Push provider name |
| voip | bool | No | When true the token is for Apple VoIP push notifications |
ErrorResult
// ErrorResult array structure
[
'stacktrace' => string, //
'type' => string, //
'version' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| type | string | Yes | |
| stacktrace | string | No | |
| version | string | No |
EventHook
// EventHook array structure
[
'callback' => AsyncModerationCallbackConfig, //
'created_at' => float, //
'enabled' => bool, //
'event_types' => array, //
'hook_type' => string, //
'id' => string, //
'product' => string, //
'should_send_custom_events' => bool, //
'sns_auth_type' => string, //
'sns_event_based_message_group_id_enabled' => bool, //
'sns_key' => string, //
'sns_region' => string, //
'sns_role_arn' => string, //
'sns_secret' => string, //
'sns_topic_arn' => string, //
'sqs_auth_type' => string, //
'sqs_key' => string, //
'sqs_queue_url' => string, //
'sqs_region' => string, //
'sqs_role_arn' => string, //
'sqs_secret' => string, //
'timeout_ms' => int, //
'updated_at' => float, //
'webhook_url' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| callback | AsyncModerationCallbackConfig | No | |
| created_at | float | No | |
| enabled | bool | No | |
| event_types | array | No | |
| hook_type | string | No | |
| id | string | No | |
| product | string | No | |
| should_send_custom_events | bool | No | |
| sns_auth_type | string | No | |
| sns_event_based_message_group_id_enabled | bool | No | |
| sns_key | string | No | |
| sns_region | string | No | |
| sns_role_arn | string | No | |
| sns_secret | string | No | |
| sns_topic_arn | string | No | |
| sqs_auth_type | string | No | |
| sqs_key | string | No | |
| sqs_queue_url | string | No | |
| sqs_region | string | No | |
| sqs_role_arn | string | No | |
| sqs_secret | string | No | |
| timeout_ms | int | No | |
| updated_at | float | No | |
| webhook_url | string | No |
ExportUserResponse
// ExportUserResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'messages' => array, // List of exported messages
'reactions' => array, // List of exported reactions
'user' => UserResponse, // Exported user object
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| messages | array | No | List of exported messages |
| reactions | array | No | List of exported reactions |
| user | UserResponse | No | Exported user object |
ExportUsersResponse
Basic response information
// ExportUsersResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'task_id' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| task_id | string | Yes |
FeedsPreferences
// FeedsPreferences array structure
[
'comment' => string, // Push notification preference for comments on user's activities. One of: all, none
'comment_mention' => string, // Push notification preference for mentions in comments. One of: all, none
'comment_reaction' => string, // Push notification preference for reactions on comments. One of: all, none
'comment_reply' => string, // Push notification preference for replies to comments. One of: all, none
'custom_activity_types' => array, // Push notification preferences for custom activity types. Map of activity type to preference (all or none)
'follow' => string, // Push notification preference for new followers. One of: all, none
'mention' => string, // Push notification preference for mentions in activities. One of: all, none
'reaction' => string, // Push notification preference for reactions on user's activities or comments. One of: all, none
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| comment | string | No | Push notification preference for comments on user's activities. One of: all, ... |
| comment_mention | string | No | Push notification preference for mentions in comments. One of: all, none |
| comment_reaction | string | No | Push notification preference for reactions on comments. One of: all, none |
| comment_reply | string | No | Push notification preference for replies to comments. One of: all, none |
| custom_activity_types | array | No | Push notification preferences for custom activity types. Map of activity type... |
| follow | string | No | Push notification preference for new followers. One of: all, none |
| mention | string | No | Push notification preference for mentions in activities. One of: all, none |
| reaction | string | No | Push notification preference for reactions on user's activities or comments. ... |
Field
// Field array structure
[
'short' => bool, //
'title' => string, //
'value' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| short | bool | Yes | |
| title | string | Yes | |
| value | string | Yes |
FileUploadConfig
// FileUploadConfig array structure
[
'allowed_file_extensions' => array, //
'allowed_mime_types' => array, //
'blocked_file_extensions' => array, //
'blocked_mime_types' => array, //
'size_limit' => int, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| size_limit | int | Yes | |
| allowed_file_extensions | array | No | |
| allowed_mime_types | array | No | |
| blocked_file_extensions | array | No | |
| blocked_mime_types | array | No |
FileUploadResponse
// FileUploadResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'file' => string, // URL to the uploaded asset. Should be used to put to `asset_url` attachment field
'thumb_url' => string, // URL of the file thumbnail for supported file formats. Should be put to `thumb_url` attachment field
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| file | string | No | URL to the uploaded asset. Should be used to put to asset_url attachment field |
| thumb_url | string | No | URL of the file thumbnail for supported file formats. Should be put to `thumb... |
FirebaseConfig
// FirebaseConfig array structure
[
'Disabled' => bool, //
'apn_template' => string, //
'credentials_json' => string, //
'data_template' => string, //
'notification_template' => string, //
'server_key' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| Disabled | bool | No | |
| apn_template | string | No | |
| credentials_json | string | No | |
| data_template | string | No | |
| notification_template | string | No | |
| server_key | string | No |
FullUserResponse
// FullUserResponse array structure
[
'avg_response_time' => int, //
'ban_expires' => float, //
'banned' => bool, //
'blocked_user_ids' => array, //
'bypass_moderation' => bool, //
'channel_mutes' => array, //
'created_at' => float, //
'custom' => array, //
'deactivated_at' => float, //
'deleted_at' => float, //
'devices' => array, //
'id' => string, //
'image' => string, //
'invisible' => bool, //
'language' => string, //
'last_active' => float, //
'latest_hidden_channels' => array, //
'mutes' => array, //
'name' => string, //
'online' => bool, //
'privacy_settings' => PrivacySettingsResponse, //
'revoke_tokens_issued_before' => float, //
'role' => string, //
'shadow_banned' => bool, //
'teams' => array, //
'teams_role' => array, //
'total_unread_count' => int, //
'unread_channels' => int, //
'unread_count' => int, //
'unread_threads' => int, //
'updated_at' => float, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| banned | bool | Yes | |
| blocked_user_ids | array | Yes | |
| channel_mutes | array | Yes | |
| created_at | float | Yes | |
| custom | array | Yes | |
| devices | array | Yes | |
| id | string | Yes | |
| invisible | bool | Yes | |
| language | string | Yes | |
| mutes | array | Yes | |
| online | bool | Yes | |
| role | string | Yes | |
| shadow_banned | bool | Yes | |
| teams | array | Yes | |
| total_unread_count | int | Yes | |
| unread_channels | int | Yes | |
| unread_count | int | Yes | |
| unread_threads | int | Yes | |
| updated_at | float | Yes | |
| avg_response_time | int | No | |
| ban_expires | float | No | |
| bypass_moderation | bool | No | |
| deactivated_at | float | No | |
| deleted_at | float | No | |
| image | string | No | |
| last_active | float | No | |
| latest_hidden_channels | array | No | |
| name | string | No | |
| privacy_settings | PrivacySettingsResponse | No | |
| revoke_tokens_issued_before | float | No | |
| teams_role | array | No |
GetApplicationResponse
Basic response information
// GetApplicationResponse array structure
[
'app' => AppResponseFields, //
'duration' => string, // Duration of the request in milliseconds
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| app | AppResponseFields | Yes | |
| duration | string | Yes | Duration of the request in milliseconds |
GetBlockListResponse
Response for get block list
// GetBlockListResponse array structure
[
'blocklist' => BlockListResponse, // Block list object
'duration' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | |
| blocklist | BlockListResponse | No | Block list object |
GetBlockedUsersResponse
// GetBlockedUsersResponse array structure
[
'blocks' => array, // Array of blocked user object
'duration' => string, // Duration of the request in milliseconds
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| blocks | array | Yes | Array of blocked user object |
| duration | string | Yes | Duration of the request in milliseconds |
GetCustomPermissionResponse
Basic response information
// GetCustomPermissionResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'permission' => Permission, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| permission | Permission | Yes |
GetExternalStorageAWSS3Response
// GetExternalStorageAWSS3Response array structure
[
'bucket' => string, //
'path_prefix' => string, //
'region' => string, //
'role_arn' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| bucket | string | Yes | |
| region | string | Yes | |
| role_arn | string | Yes | |
| path_prefix | string | No |
GetExternalStorageResponse
Basic response information
// GetExternalStorageResponse array structure
[
'aws_s3' => GetExternalStorageAWSS3Response, //
'created_at' => float, //
'duration' => string, // Duration of the request in milliseconds
'type' => string, //
'updated_at' => float, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| created_at | float | Yes | |
| duration | string | Yes | Duration of the request in milliseconds |
| type | string | Yes | |
| updated_at | float | Yes | |
| aws_s3 | GetExternalStorageAWSS3Response | No |
GetImportResponse
Basic response information
// GetImportResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'import_task' => ImportTask, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| import_task | ImportTask | No |
GetImportV2TaskResponse
Basic response information
// GetImportV2TaskResponse array structure
[
'app_pk' => int, //
'created_at' => float, //
'duration' => string, // Duration of the request in milliseconds
'id' => string, //
'product' => string, //
'result' => array, //
'settings' => ImportV2TaskSettings, //
'state' => int, //
'updated_at' => float, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| app_pk | int | Yes | |
| created_at | float | Yes | |
| duration | string | Yes | Duration of the request in milliseconds |
| id | string | Yes | |
| product | string | Yes | |
| settings | ImportV2TaskSettings | Yes | |
| state | int | Yes | |
| updated_at | float | Yes | |
| result | array | No |
GetOGResponse
// GetOGResponse array structure
[
'actions' => array, //
'asset_url' => string, // URL of detected video or audio
'author_icon' => string, //
'author_link' => string, // og:site
'author_name' => string, // og:site_name
'color' => string, //
'custom' => array, //
'duration' => string, //
'fallback' => string, //
'fields' => array, //
'footer' => string, //
'footer_icon' => string, //
'giphy' => Images, //
'image_url' => string, // URL of detected image
'og_scrape_url' => string, // extracted url from the text
'original_height' => int, //
'original_width' => int, //
'pretext' => string, //
'text' => string, // og:description
'thumb_url' => string, // URL of detected thumb image
'title' => string, // og:title
'title_link' => string, // og:url
'type' => string, // Attachment type, could be empty, image, audio or video
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| custom | array | Yes | |
| duration | string | Yes | |
| actions | array | No | |
| asset_url | string | No | URL of detected video or audio |
| author_icon | string | No | |
| author_link | string | No | og:site |
| author_name | string | No | og:site_name |
| color | string | No | |
| fallback | string | No | |
| fields | array | No | |
| footer | string | No | |
| footer_icon | string | No | |
| giphy | Images | No | |
| image_url | string | No | URL of detected image |
| og_scrape_url | string | No | extracted url from the text |
| original_height | int | No | |
| original_width | int | No | |
| pretext | string | No | |
| text | string | No | og:description |
| thumb_url | string | No | URL of detected thumb image |
| title | string | No | og:title |
| title_link | string | No | og:url |
| type | string | No | Attachment type, could be empty, image, audio or video |
GetPushTemplatesResponse
Basic response information
// GetPushTemplatesResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'templates' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| templates | array | Yes |
GetRateLimitsResponse
// GetRateLimitsResponse array structure
[
'android' => array, // Map of endpoint rate limits for the Android platform
'duration' => string, //
'ios' => array, // Map of endpoint rate limits for the iOS platform
'server_side' => array, // Map of endpoint rate limits for the server-side platform
'web' => array, // Map of endpoint rate limits for the web platform
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | |
| android | array | No | Map of endpoint rate limits for the Android platform |
| ios | array | No | Map of endpoint rate limits for the iOS platform |
| server_side | array | No | Map of endpoint rate limits for the server-side platform |
| web | array | No | Map of endpoint rate limits for the web platform |
GetTaskResponse
// GetTaskResponse array structure
[
'created_at' => float, //
'duration' => string, //
'error' => ErrorResult, // Error produced by task
'result' => array, // Result produced by task after completion
'status' => string, // Current status of task
'task_id' => string, // ID of task
'updated_at' => float, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| created_at | float | Yes | |
| duration | string | Yes | |
| status | string | Yes | Current status of task |
| task_id | string | Yes | ID of task |
| updated_at | float | Yes | |
| error | ErrorResult | No | Error produced by task |
| result | array | No | Result produced by task after completion |
GetUserGroupResponse
Response for getting a user group
// GetUserGroupResponse array structure
[
'duration' => string, //
'user_group' => UserGroupResponse, // The user group
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | |
| user_group | UserGroupResponse | No | The user group |
GoogleVisionConfig
// GoogleVisionConfig array structure
[
'enabled' => bool, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| enabled | bool | No |
HuaweiConfig
// HuaweiConfig array structure
[
'Disabled' => bool, //
'id' => string, //
'secret' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| Disabled | bool | No | |
| id | string | No | |
| secret | string | No |
ImageSize
// ImageSize array structure
[
'crop' => string, // Crop mode. One of: top, bottom, left, right, center
'height' => int, // Target image height
'resize' => string, // Resize method. One of: clip, crop, scale, fill
'width' => int, // Target image width
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| crop | string | No | Crop mode. One of: top, bottom, left, right, center |
| height | int | No | Target image height |
| resize | string | No | Resize method. One of: clip, crop, scale, fill |
| width | int | No | Target image width |
ImageUploadResponse
// ImageUploadResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'file' => string, //
'thumb_url' => string, //
'upload_sizes' => array, // Array of image size configurations
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| file | string | No | |
| thumb_url | string | No | |
| upload_sizes | array | No | Array of image size configurations |
Images
// Images array structure
[
'fixed_height' => ImageData, //
'fixed_height_downsampled' => ImageData, //
'fixed_height_still' => ImageData, //
'fixed_width' => ImageData, //
'fixed_width_downsampled' => ImageData, //
'fixed_width_still' => ImageData, //
'original' => ImageData, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| fixed_height | ImageData | Yes | |
| fixed_height_downsampled | ImageData | Yes | |
| fixed_height_still | ImageData | Yes | |
| fixed_width | ImageData | Yes | |
| fixed_width_downsampled | ImageData | Yes | |
| fixed_width_still | ImageData | Yes | |
| original | ImageData | Yes |
ImportTask
// ImportTask array structure
[
'created_at' => float, //
'history' => array, //
'id' => string, //
'mode' => string, //
'path' => string, //
'size' => int, //
'state' => string, //
'updated_at' => float, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| created_at | float | Yes | |
| history | array | Yes | |
| id | string | Yes | |
| mode | string | Yes | |
| path | string | Yes | |
| state | string | Yes | |
| updated_at | float | Yes | |
| size | int | No |
ImportV2TaskItem
// ImportV2TaskItem array structure
[
'app_pk' => int, //
'created_at' => float, //
'id' => string, //
'product' => string, //
'result' => array, //
'settings' => ImportV2TaskSettings, //
'state' => int, //
'updated_at' => float, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| app_pk | int | Yes | |
| created_at | float | Yes | |
| id | string | Yes | |
| product | string | Yes | |
| settings | ImportV2TaskSettings | Yes | |
| state | int | Yes | |
| updated_at | float | Yes | |
| result | array | No |
ImportV2TaskSettings
// ImportV2TaskSettings array structure
[
'merge_custom' => bool, //
'mode' => string, //
'path' => string, //
's3' => ImportV2TaskSettingsS3, //
'skip_references_check' => bool, //
'source' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| merge_custom | bool | No | |
| mode | string | No | |
| path | string | No | |
| s3 | ImportV2TaskSettingsS3 | No | |
| skip_references_check | bool | No | |
| source | string | No |
ImportV2TaskSettingsS3
// ImportV2TaskSettingsS3 array structure
[
'bucket' => string, //
'dir' => string, //
'region' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| bucket | string | No | |
| dir | string | No | |
| region | string | No |
LLMConfig
// LLMConfig array structure
[
'app_context' => string, //
'async' => bool, //
'enabled' => bool, //
'rules' => array, //
'severity_descriptions' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| app_context | string | No | |
| async | bool | No | |
| enabled | bool | No | |
| rules | array | No | |
| severity_descriptions | array | No |
ListBlockListResponse
Basic response information
// ListBlockListResponse array structure
[
'blocklists' => array, //
'duration' => string, // Duration of the request in milliseconds
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| blocklists | array | Yes | |
| duration | string | Yes | Duration of the request in milliseconds |
ListDevicesResponse
List devices response
// ListDevicesResponse array structure
[
'devices' => array, // List of devices
'duration' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| devices | array | Yes | List of devices |
| duration | string | Yes |
ListExternalStorageResponse
Basic response information
// ListExternalStorageResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'external_storages' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| external_storages | array | Yes |
ListImportV2TasksResponse
Basic response information
// ListImportV2TasksResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'import_tasks' => array, //
'next' => string, //
'prev' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| import_tasks | array | Yes | |
| next | string | No | |
| prev | string | No |
ListImportsResponse
Basic response information
// ListImportsResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'import_tasks' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| import_tasks | array | Yes |
ListPermissionsResponse
Basic response information
// ListPermissionsResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'permissions' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| permissions | array | Yes |
ListPushProvidersResponse
Basic response information
// ListPushProvidersResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'push_providers' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| push_providers | array | Yes |
ListRolesResponse
Basic response information
// ListRolesResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'roles' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| roles | array | Yes |
ListUserGroupsResponse
Response for listing user groups
// ListUserGroupsResponse array structure
[
'duration' => string, //
'user_groups' => array, // List of user groups
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | |
| user_groups | array | Yes | List of user groups |
MessageResponse
Represents any chat message
// MessageResponse array structure
[
'attachments' => array, // Array of message attachments
'cid' => string, // Channel unique identifier in <type>:<id> format
'command' => string, // Contains provided slash command
'created_at' => float, // Date/time of creation
'custom' => array, //
'deleted_at' => float, // Date/time of deletion
'deleted_for_me' => bool, //
'deleted_reply_count' => int, //
'draft' => DraftResponse, //
'html' => string, // Contains HTML markup of the message. Can only be set when using server-side API
'i18n' => array, // Object with translations. Key `language` contains the original language key. Other keys contain translations
'id' => string, // Message ID is unique string identifier of the message
'image_labels' => array, // Contains image moderation information
'latest_reactions' => array, // List of 10 latest reactions to this message
'member' => ChannelMemberResponse, // Channel member data for the message sender including only the `channel_role`
'mentioned_channel' => bool, // Whether the message mentioned the channel tag
'mentioned_group_ids' => array, // List of user group IDs mentioned in the message. Group members who are also channel members will receive push notifications based on their push preferences. Max 10 groups
'mentioned_here' => bool, // Whether the message mentioned online users with @here tag
'mentioned_roles' => array, // List of roles mentioned in the message (e.g. admin, channel_moderator, custom roles). Members with matching roles will receive push notifications based on their push preferences. Max 10 roles
'mentioned_users' => array, // List of mentioned users
'message_text_updated_at' => float, //
'mml' => string, // Should be empty if `text` is provided. Can only be set when using server-side API
'moderation' => ModerationV2Response, //
'own_reactions' => array, // List of 10 latest reactions of authenticated user to this message
'parent_id' => string, // ID of parent message (thread)
'pin_expires' => float, // Date when pinned message expires
'pinned' => bool, // Whether message is pinned or not
'pinned_at' => float, // Date when message got pinned
'pinned_by' => UserResponse, // Contains user who pinned the message
'poll' => PollResponseData, //
'poll_id' => string, // Identifier of the poll to include in the message
'quoted_message' => MessageResponse, // Contains quoted message
'quoted_message_id' => string, //
'reaction_counts' => array, // An object containing number of reactions of each type. Key: reaction type (string), value: number of reactions (int)
'reaction_groups' => array, //
'reaction_scores' => array, // An object containing scores of reactions of each type. Key: reaction type (string), value: total score of reactions (int)
'reminder' => ReminderResponseData, //
'reply_count' => int, // Number of replies to this message
'restricted_visibility' => array, // A list of user ids that have restricted visibility to the message, if the list is not empty, the message is only visible to the users in the list
'shadowed' => bool, // Whether the message was shadowed or not
'shared_location' => SharedLocationResponseData, // Contains shared location data
'show_in_channel' => bool, // Whether thread reply should be shown in the channel as well
'silent' => bool, // Whether message is silent or not
'text' => string, // Text of the message. Should be empty if `mml` is provided
'thread_participants' => array, // List of users who participate in thread
'type' => string, // Contains type of the message. One of: regular, ephemeral, error, reply, system, deleted
'updated_at' => float, // Date/time of the last update
'user' => UserResponse, // Sender of the message. Required when using server-side API
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| attachments | array | Yes | Array of message attachments |
| cid | string | Yes | Channel unique identifier in <type>:<id> format |
| created_at | float | Yes | Date/time of creation |
| custom | array | Yes | |
| deleted_reply_count | int | Yes | |
| html | string | Yes | Contains HTML markup of the message. Can only be set when using server-side API |
| id | string | Yes | Message ID is unique string identifier of the message |
| latest_reactions | array | Yes | List of 10 latest reactions to this message |
| mentioned_channel | bool | Yes | Whether the message mentioned the channel tag |
| mentioned_here | bool | Yes | Whether the message mentioned online users with @here tag |
| mentioned_users | array | Yes | List of mentioned users |
| own_reactions | array | Yes | List of 10 latest reactions of authenticated user to this message |
| pinned | bool | Yes | Whether message is pinned or not |
| reaction_counts | array | Yes | An object containing number of reactions of each type. Key: reaction type (st... |
| reaction_scores | array | Yes | An object containing scores of reactions of each type. Key: reaction type (st... |
| reply_count | int | Yes | Number of replies to this message |
| restricted_visibility | array | Yes | A list of user ids that have restricted visibility to the message, if the lis... |
| shadowed | bool | Yes | Whether the message was shadowed or not |
| silent | bool | Yes | Whether message is silent or not |
| text | string | Yes | Text of the message. Should be empty if mml is provided |
| type | string | Yes | Contains type of the message. One of: regular, ephemeral, error, reply, syste... |
| updated_at | float | Yes | Date/time of the last update |
| user | UserResponse | Yes | Sender of the message. Required when using server-side API |
| command | string | No | Contains provided slash command |
| deleted_at | float | No | Date/time of deletion |
| deleted_for_me | bool | No | |
| draft | DraftResponse | No | |
| i18n | array | No | Object with translations. Key language contains the original language key. ... |
| image_labels | array | No | Contains image moderation information |
| member | ChannelMemberResponse | No | Channel member data for the message sender including only the channel_role |
| mentioned_group_ids | array | No | List of user group IDs mentioned in the message. Group members who are also c... |
| mentioned_roles | array | No | List of roles mentioned in the message (e.g. admin, channel_moderator, custom... |
| message_text_updated_at | float | No | |
| mml | string | No | Should be empty if text is provided. Can only be set when using server-side... |
| moderation | ModerationV2Response | No | |
| parent_id | string | No | ID of parent message (thread) |
| pin_expires | float | No | Date when pinned message expires |
| pinned_at | float | No | Date when message got pinned |
| pinned_by | UserResponse | No | Contains user who pinned the message |
| poll | PollResponseData | No | |
| poll_id | string | No | Identifier of the poll to include in the message |
| quoted_message | MessageResponse | No | Contains quoted message |
| quoted_message_id | string | No | |
| reaction_groups | array | No | |
| reminder | ReminderResponseData | No | |
| shared_location | SharedLocationResponseData | No | Contains shared location data |
| show_in_channel | bool | No | Whether thread reply should be shown in the channel as well |
| thread_participants | array | No | List of users who participate in thread |
ModerationConfig
// ModerationConfig array structure
[
'ai_image_config' => AIImageConfig, //
'ai_image_lite_config' => BodyguardImageAnalysisConfig, //
'ai_text_config' => AITextConfig, //
'ai_video_config' => AIVideoConfig, //
'async' => bool, //
'automod_platform_circumvention_config' => AutomodPlatformCircumventionConfig, //
'automod_semantic_filters_config' => AutomodSemanticFiltersConfig, //
'automod_toxicity_config' => AutomodToxicityConfig, //
'block_list_config' => BlockListConfig, //
'created_at' => float, //
'google_vision_config' => GoogleVisionConfig, //
'key' => string, //
'llm_config' => LLMConfig, //
'supported_video_call_harm_types' => array, //
'team' => string, //
'updated_at' => float, //
'velocity_filter_config' => VelocityFilterConfig, //
'video_call_rule_config' => VideoCallRuleConfig, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| ai_image_config | AIImageConfig | No | |
| ai_image_lite_config | BodyguardImageAnalysisConfig | No | |
| ai_text_config | AITextConfig | No | |
| ai_video_config | AIVideoConfig | No | |
| async | bool | No | |
| automod_platform_circumvention_config | AutomodPlatformCircumventionConfig | No | |
| automod_semantic_filters_config | AutomodSemanticFiltersConfig | No | |
| automod_toxicity_config | AutomodToxicityConfig | No | |
| block_list_config | BlockListConfig | No | |
| created_at | float | No | |
| google_vision_config | GoogleVisionConfig | No | |
| key | string | No | |
| llm_config | LLMConfig | No | |
| supported_video_call_harm_types | array | No | |
| team | string | No | |
| updated_at | float | No | |
| velocity_filter_config | VelocityFilterConfig | No | |
| video_call_rule_config | VideoCallRuleConfig | No |
ModerationDashboardPreferences
// ModerationDashboardPreferences array structure
[
'allowed_moderation_action_reasons' => array, //
'async_review_queue_upsert' => bool, //
'disable_audit_logs' => bool, //
'disable_flagging_reviewed_entity' => bool, //
'escalation_queue_enabled' => bool, //
'escalation_reasons' => array, //
'flag_user_on_flagged_content' => bool, //
'keyframe_classifications_map' => array, //
'media_queue_blur_enabled' => bool, //
'overview_dashboard' => OverviewDashboardConfig, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| allowed_moderation_action_reasons | array | No | |
| async_review_queue_upsert | bool | No | |
| disable_audit_logs | bool | No | |
| disable_flagging_reviewed_entity | bool | No | |
| escalation_queue_enabled | bool | No | |
| escalation_reasons | array | No | |
| flag_user_on_flagged_content | bool | No | |
| keyframe_classifications_map | array | No | |
| media_queue_blur_enabled | bool | No | |
| overview_dashboard | OverviewDashboardConfig | No |
OnlyUserID
// OnlyUserID array structure
[
'id' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| id | string | Yes |
OverviewDashboardConfig
// OverviewDashboardConfig array structure
[
'default_date_range_days' => int, //
'visible_charts' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| default_date_range_days | int | No | |
| visible_charts | array | No |
PagerRequest
// PagerRequest array structure
[
'limit' => int, //
'next' => string, //
'prev' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| limit | int | No | |
| next | string | No | |
| prev | string | No |
Permission
// Permission array structure
[
'action' => string, // Action name this permission is for (e.g. SendMessage)
'condition' => array, // MongoDB style condition which decides whether or not the permission is granted
'custom' => bool, // Whether this is a custom permission or built-in
'description' => string, // Description of the permission
'id' => string, // Unique permission ID
'level' => string, // Level at which permission could be applied (app or channel). One of: app, channel
'name' => string, // Name of the permission
'owner' => bool, // Whether this permission applies to resource owner or not
'same_team' => bool, // Whether this permission applies to teammates (multi-tenancy mode only)
'tags' => array, // List of tags of the permission
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| action | string | Yes | Action name this permission is for (e.g. SendMessage) |
| custom | bool | Yes | Whether this is a custom permission or built-in |
| description | string | Yes | Description of the permission |
| id | string | Yes | Unique permission ID |
| level | string | Yes | Level at which permission could be applied (app or channel). One of: app, cha... |
| name | string | Yes | Name of the permission |
| owner | bool | Yes | Whether this permission applies to resource owner or not |
| same_team | bool | Yes | Whether this permission applies to teammates (multi-tenancy mode only) |
| tags | array | Yes | List of tags of the permission |
| condition | array | No | MongoDB style condition which decides whether or not the permission is granted |
PollOptionInput
// PollOptionInput array structure
[
'custom' => array, //
'text' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| custom | array | No | |
| text | string | No |
PollOptionRequest
// PollOptionRequest array structure
[
'custom' => array, //
'id' => string, //
'text' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | |
| custom | array | No | |
| text | string | No |
PollOptionResponse
// PollOptionResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'poll_option' => PollOptionResponseData, // Poll option
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| poll_option | PollOptionResponseData | Yes | Poll option |
PollOptionResponseData
// PollOptionResponseData array structure
[
'custom' => array, //
'id' => string, //
'text' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| custom | array | Yes | |
| id | string | Yes | |
| text | string | Yes |
PollResponse
// PollResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'poll' => PollResponseData, // Poll
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| poll | PollResponseData | Yes | Poll |
PollResponseData
// PollResponseData array structure
[
'allow_answers' => bool, //
'allow_user_suggested_options' => bool, //
'answers_count' => int, //
'created_at' => float, //
'created_by' => UserResponse, //
'created_by_id' => string, //
'custom' => array, //
'description' => string, //
'enforce_unique_vote' => bool, //
'id' => string, //
'is_closed' => bool, //
'latest_answers' => array, //
'latest_votes_by_option' => array, //
'max_votes_allowed' => int, //
'name' => string, //
'options' => array, //
'own_votes' => array, //
'updated_at' => float, //
'vote_count' => int, //
'vote_counts_by_option' => array, //
'voting_visibility' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| allow_answers | bool | Yes | |
| allow_user_suggested_options | bool | Yes | |
| answers_count | int | Yes | |
| created_at | float | Yes | |
| created_by_id | string | Yes | |
| custom | array | Yes | |
| description | string | Yes | |
| enforce_unique_vote | bool | Yes | |
| id | string | Yes | |
| latest_answers | array | Yes | |
| latest_votes_by_option | array | Yes | |
| name | string | Yes | |
| options | array | Yes | |
| own_votes | array | Yes | |
| updated_at | float | Yes | |
| vote_count | int | Yes | |
| vote_counts_by_option | array | Yes | |
| voting_visibility | string | Yes | |
| created_by | UserResponse | No | |
| is_closed | bool | No | |
| max_votes_allowed | int | No |
PollVoteResponseData
// PollVoteResponseData array structure
[
'answer_text' => string, //
'created_at' => float, //
'id' => string, //
'is_answer' => bool, //
'option_id' => string, //
'poll_id' => string, //
'updated_at' => float, //
'user' => UserResponse, //
'user_id' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| created_at | float | Yes | |
| id | string | Yes | |
| option_id | string | Yes | |
| poll_id | string | Yes | |
| updated_at | float | Yes | |
| answer_text | string | No | |
| is_answer | bool | No | |
| user | UserResponse | No | |
| user_id | string | No |
PollVotesResponse
// PollVotesResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'next' => string, //
'prev' => string, //
'votes' => array, // Poll votes
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| votes | array | Yes | Poll votes |
| next | string | No | |
| prev | string | No |
PrivacySettingsResponse
// PrivacySettingsResponse array structure
[
'delivery_receipts' => DeliveryReceiptsResponse, //
'read_receipts' => ReadReceiptsResponse, //
'typing_indicators' => TypingIndicatorsResponse, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| delivery_receipts | DeliveryReceiptsResponse | No | |
| read_receipts | ReadReceiptsResponse | No | |
| typing_indicators | TypingIndicatorsResponse | No |
PushConfig
// PushConfig array structure
[
'offline_only' => bool, //
'version' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| version | string | Yes | |
| offline_only | bool | No |
PushPreferenceInput
// PushPreferenceInput array structure
[
'call_level' => string, // Set the level of call push notifications for the user. One of: all, none, default
'channel_cid' => string, // Set the push preferences for a specific channel. If empty it sets the default for the user
'chat_level' => string, // Set the level of chat push notifications for the user. Note: "mentions" is deprecated in favor of "direct_mentions". One of: all, mentions, direct_mentions, all_mentions, none, default
'chat_preferences' => ChatPreferencesInput, //
'disabled_until' => float, // Disable push notifications till a certain time
'feeds_level' => string, // Set the level of feeds push notifications for the user. One of: all, none, default
'feeds_preferences' => FeedsPreferences, // Set granular feeds preferences for reactions, comments, new followers, mentions, and custom activity types
'remove_disable' => bool, // Remove the disabled until time. (IE stop snoozing notifications)
'user_id' => string, // The user id for which to set the push preferences. Required when using server side auths, defaults to current user with client side auth.
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| call_level | string | No | Set the level of call push notifications for the user. One of: all, none, def... |
| channel_cid | string | No | Set the push preferences for a specific channel. If empty it sets the default... |
| chat_level | string | No | Set the level of chat push notifications for the user. Note: "mentions" is de... |
| chat_preferences | ChatPreferencesInput | No | |
| disabled_until | float | No | Disable push notifications till a certain time |
| feeds_level | string | No | Set the level of feeds push notifications for the user. One of: all, none, de... |
| feeds_preferences | FeedsPreferences | No | Set granular feeds preferences for reactions, comments, new followers, mentio... |
| remove_disable | bool | No | Remove the disabled until time. (IE stop snoozing notifications) |
| user_id | string | No | The user id for which to set the push preferences. Required when using server... |
PushProvider
// PushProvider array structure
[
'apn_auth_key' => string, //
'apn_auth_type' => string, //
'apn_development' => bool, //
'apn_host' => string, //
'apn_key_id' => string, //
'apn_notification_template' => string, //
'apn_p12_cert' => string, //
'apn_team_id' => string, //
'apn_topic' => string, //
'created_at' => float, //
'description' => string, //
'disabled_at' => float, //
'disabled_reason' => string, //
'firebase_apn_template' => string, //
'firebase_credentials' => string, //
'firebase_data_template' => string, //
'firebase_host' => string, //
'firebase_notification_template' => string, //
'firebase_server_key' => string, //
'huawei_app_id' => string, //
'huawei_app_secret' => string, //
'huawei_host' => string, //
'name' => string, //
'push_templates' => array, //
'type' => string, //
'updated_at' => float, //
'xiaomi_app_secret' => string, //
'xiaomi_package_name' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| created_at | float | Yes | |
| name | string | Yes | |
| type | string | Yes | |
| updated_at | float | Yes | |
| apn_auth_key | string | No | |
| apn_auth_type | string | No | |
| apn_development | bool | No | |
| apn_host | string | No | |
| apn_key_id | string | No | |
| apn_notification_template | string | No | |
| apn_p12_cert | string | No | |
| apn_team_id | string | No | |
| apn_topic | string | No | |
| description | string | No | |
| disabled_at | float | No | |
| disabled_reason | string | No | |
| firebase_apn_template | string | No | |
| firebase_credentials | string | No | |
| firebase_data_template | string | No | |
| firebase_host | string | No | |
| firebase_notification_template | string | No | |
| firebase_server_key | string | No | |
| huawei_app_id | string | No | |
| huawei_app_secret | string | No | |
| huawei_host | string | No | |
| push_templates | array | No | |
| xiaomi_app_secret | string | No | |
| xiaomi_package_name | string | No |
PushProviderRequest
// PushProviderRequest array structure
[
'apn_auth_key' => string, //
'apn_auth_type' => string, //
'apn_development' => bool, //
'apn_host' => string, //
'apn_key_id' => string, //
'apn_notification_template' => string, //
'apn_p12_cert' => string, //
'apn_team_id' => string, //
'apn_topic' => string, //
'description' => string, //
'disabled_at' => float, //
'disabled_reason' => string, //
'firebase_apn_template' => string, //
'firebase_credentials' => string, //
'firebase_data_template' => string, //
'firebase_host' => string, //
'firebase_notification_template' => string, //
'firebase_server_key' => string, //
'huawei_app_id' => string, //
'huawei_app_secret' => string, //
'name' => string, //
'type' => string, //
'xiaomi_app_secret' => string, //
'xiaomi_package_name' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | |
| apn_auth_key | string | No | |
| apn_auth_type | string | No | |
| apn_development | bool | No | |
| apn_host | string | No | |
| apn_key_id | string | No | |
| apn_notification_template | string | No | |
| apn_p12_cert | string | No | |
| apn_team_id | string | No | |
| apn_topic | string | No | |
| description | string | No | |
| disabled_at | float | No | |
| disabled_reason | string | No | |
| firebase_apn_template | string | No | |
| firebase_credentials | string | No | |
| firebase_data_template | string | No | |
| firebase_host | string | No | |
| firebase_notification_template | string | No | |
| firebase_server_key | string | No | |
| huawei_app_id | string | No | |
| huawei_app_secret | string | No | |
| type | string | No | |
| xiaomi_app_secret | string | No | |
| xiaomi_package_name | string | No |
PushProviderResponse
// PushProviderResponse array structure
[
'apn_auth_key' => string, //
'apn_auth_type' => string, //
'apn_development' => bool, //
'apn_host' => string, //
'apn_key_id' => string, //
'apn_p12_cert' => string, //
'apn_sandbox_certificate' => bool, //
'apn_supports_remote_notifications' => bool, //
'apn_supports_voip_notifications' => bool, //
'apn_team_id' => string, //
'apn_topic' => string, //
'created_at' => float, //
'description' => string, //
'disabled_at' => float, //
'disabled_reason' => string, //
'firebase_apn_template' => string, //
'firebase_credentials' => string, //
'firebase_data_template' => string, //
'firebase_host' => string, //
'firebase_notification_template' => string, //
'firebase_server_key' => string, //
'huawei_app_id' => string, //
'huawei_app_secret' => string, //
'name' => string, //
'type' => string, //
'updated_at' => float, //
'xiaomi_app_secret' => string, //
'xiaomi_package_name' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| created_at | float | Yes | |
| name | string | Yes | |
| type | string | Yes | |
| updated_at | float | Yes | |
| apn_auth_key | string | No | |
| apn_auth_type | string | No | |
| apn_development | bool | No | |
| apn_host | string | No | |
| apn_key_id | string | No | |
| apn_p12_cert | string | No | |
| apn_sandbox_certificate | bool | No | |
| apn_supports_remote_notifications | bool | No | |
| apn_supports_voip_notifications | bool | No | |
| apn_team_id | string | No | |
| apn_topic | string | No | |
| description | string | No | |
| disabled_at | float | No | |
| disabled_reason | string | No | |
| firebase_apn_template | string | No | |
| firebase_credentials | string | No | |
| firebase_data_template | string | No | |
| firebase_host | string | No | |
| firebase_notification_template | string | No | |
| firebase_server_key | string | No | |
| huawei_app_id | string | No | |
| huawei_app_secret | string | No | |
| xiaomi_app_secret | string | No | |
| xiaomi_package_name | string | No |
PushTemplate
// PushTemplate array structure
[
'created_at' => float, //
'enable_push' => bool, //
'event_type' => string, //
'template' => string, //
'updated_at' => float, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| created_at | float | Yes | |
| enable_push | bool | Yes | |
| event_type | string | Yes | |
| updated_at | float | Yes | |
| template | string | No |
PushTemplateResponse
// PushTemplateResponse array structure
[
'created_at' => float, // Time when the template was created
'enable_push' => bool, // Whether push notification is enabled for this event
'event_type' => string, // Type of event this template applies to
'push_provider_internal_id' => string, // Internal ID of the push provider
'template' => string, // The push notification template
'updated_at' => float, // Time when the template was last updated
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| created_at | float | Yes | Time when the template was created |
| enable_push | bool | Yes | Whether push notification is enabled for this event |
| event_type | string | Yes | Type of event this template applies to |
| push_provider_internal_id | string | Yes | Internal ID of the push provider |
| updated_at | float | Yes | Time when the template was last updated |
| template | string | No | The push notification template |
QueryPollsResponse
// QueryPollsResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'next' => string, //
'polls' => array, // Polls data returned by the query
'prev' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| polls | array | Yes | Polls data returned by the query |
| next | string | No | |
| prev | string | No |
QueryUsersResponse
// QueryUsersResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'users' => array, // Array of users as result of filters applied.
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| users | array | Yes | Array of users as result of filters applied. |
ReactionResponse
// ReactionResponse array structure
[
'created_at' => float, // Date/time of creation
'custom' => array, // Custom data for this object
'message_id' => string, // Message ID
'score' => int, // Score of the reaction
'type' => string, // Type of reaction
'updated_at' => float, // Date/time of the last update
'user' => UserResponse, // User
'user_id' => string, // User ID
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| created_at | float | Yes | Date/time of creation |
| custom | array | Yes | Custom data for this object |
| message_id | string | Yes | Message ID |
| score | int | Yes | Score of the reaction |
| type | string | Yes | Type of reaction |
| updated_at | float | Yes | Date/time of the last update |
| user | UserResponse | Yes | User |
| user_id | string | Yes | User ID |
ReactivateUserResponse
// ReactivateUserResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'user' => UserResponse, // Deactivated user object
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| user | UserResponse | No | Deactivated user object |
ReactivateUsersResponse
Basic response information
// ReactivateUsersResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'task_id' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| task_id | string | Yes |
RemoveUserGroupMembersResponse
Response for removing members from a user group
// RemoveUserGroupMembersResponse array structure
[
'duration' => string, //
'user_group' => UserGroupResponse, // The updated user group
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | |
| user_group | UserGroupResponse | No | The updated user group |
Response
Basic response information
// Response array structure
[
'duration' => string, // Duration of the request in milliseconds
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
Role
// Role array structure
[
'created_at' => float, // Date/time of creation
'custom' => bool, // Whether this is a custom role or built-in
'name' => string, // Unique role name
'scopes' => array, // List of scopes where this role is currently present. `.app` means that role is present in app-level grants
'updated_at' => float, // Date/time of the last update
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| created_at | float | Yes | Date/time of creation |
| custom | bool | Yes | Whether this is a custom role or built-in |
| name | string | Yes | Unique role name |
| scopes | array | Yes | List of scopes where this role is currently present. .app means that role i... |
| updated_at | float | Yes | Date/time of the last update |
S3Request
Config for creating Amazon S3 storage.
// S3Request array structure
[
's3_api_key' => string, // The AWS API key. To use Amazon S3 as your storage provider, you have two authentication options: IAM role or API key. If you do not specify the `s3_api_key` parameter, Stream will use IAM role authentication. In that case make sure to have the correct IAM role configured for your application.
's3_custom_endpoint_url' => string, // The custom endpoint for S3. If you want to use a custom endpoint, you must also provide the `s3_api_key` and `s3_secret` parameters.
's3_region' => string, // The AWS region where the bucket is hosted
's3_secret' => string, // The AWS API Secret
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| s3_region | string | Yes | The AWS region where the bucket is hosted |
| s3_api_key | string | No | The AWS API key. To use Amazon S3 as your storage provider, you have two auth... |
| s3_custom_endpoint_url | string | No | The custom endpoint for S3. If you want to use a custom endpoint, you must al... |
| s3_secret | string | No | The AWS API Secret |
SearchUserGroupsResponse
Response for searching user groups
// SearchUserGroupsResponse array structure
[
'duration' => string, //
'user_groups' => array, // List of matching user groups
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | |
| user_groups | array | Yes | List of matching user groups |
SharedLocationResponse
// SharedLocationResponse array structure
[
'channel' => ChannelResponse, //
'channel_cid' => string, // Channel CID
'created_at' => float, // Date/time of creation
'created_by_device_id' => string, // Device ID that created the live location
'duration' => string, //
'end_at' => float, // Time when the live location expires
'latitude' => float, // Latitude coordinate
'longitude' => float, // Longitude coordinate
'message' => MessageResponse, //
'message_id' => string, // Message ID
'updated_at' => float, // Date/time of the last update
'user_id' => string, // User ID
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| channel_cid | string | Yes | Channel CID |
| created_at | float | Yes | Date/time of creation |
| created_by_device_id | string | Yes | Device ID that created the live location |
| duration | string | Yes | |
| latitude | float | Yes | Latitude coordinate |
| longitude | float | Yes | Longitude coordinate |
| message_id | string | Yes | Message ID |
| updated_at | float | Yes | Date/time of the last update |
| user_id | string | Yes | User ID |
| channel | ChannelResponse | No | |
| end_at | float | No | Time when the live location expires |
| message | MessageResponse | No |
SharedLocationResponseData
// SharedLocationResponseData array structure
[
'channel' => ChannelResponse, //
'channel_cid' => string, //
'created_at' => float, //
'created_by_device_id' => string, //
'end_at' => float, //
'latitude' => float, //
'longitude' => float, //
'message' => MessageResponse, //
'message_id' => string, //
'updated_at' => float, //
'user_id' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| channel_cid | string | Yes | |
| created_at | float | Yes | |
| created_by_device_id | string | Yes | |
| latitude | float | Yes | |
| longitude | float | Yes | |
| message_id | string | Yes | |
| updated_at | float | Yes | |
| user_id | string | Yes | |
| channel | ChannelResponse | No | |
| end_at | float | No | |
| message | MessageResponse | No |
SharedLocationsResponse
// SharedLocationsResponse array structure
[
'active_live_locations' => array, //
'duration' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| active_live_locations | array | Yes | |
| duration | string | Yes |
SortParamRequest
// SortParamRequest array structure
[
'direction' => int, // Direction of sorting, 1 for Ascending, -1 for Descending, default is 1. One of: -1, 1
'field' => string, // Name of field to sort by
'type' => string, // Type of field to sort by. Empty string or omitted means string type (default). One of: number, boolean
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| direction | int | No | Direction of sorting, 1 for Ascending, -1 for Descending, default is 1. One o... |
| field | string | No | Name of field to sort by |
| type | string | No | Type of field to sort by. Empty string or omitted means string type (default)... |
Time
// Time array structure
[
]UnblockUsersResponse
// UnblockUsersResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
UpdateBlockListResponse
Basic response information
// UpdateBlockListResponse array structure
[
'blocklist' => BlockListResponse, //
'duration' => string, // Duration of the request in milliseconds
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| blocklist | BlockListResponse | No |
UpdateExternalStorageResponse
Basic response information
// UpdateExternalStorageResponse array structure
[
'bucket' => string, //
'duration' => string, // Duration of the request in milliseconds
'name' => string, //
'path' => string, //
'type' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| bucket | string | Yes | |
| duration | string | Yes | Duration of the request in milliseconds |
| name | string | Yes | |
| path | string | Yes | |
| type | string | Yes |
UpdateUserGroupResponse
Response for updating a user group
// UpdateUserGroupResponse array structure
[
'duration' => string, //
'user_group' => UserGroupResponse, // The updated user group
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | |
| user_group | UserGroupResponse | No | The updated user group |
UpdateUserPartialRequest
// UpdateUserPartialRequest array structure
[
'id' => string, // User ID to update
'set' => array, //
'unset' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | User ID to update |
| set | array | No | |
| unset | array | No |
UpdateUsersResponse
// UpdateUsersResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'membership_deletion_task_id' => string, //
'users' => array, // Object containing users
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| membership_deletion_task_id | string | Yes | |
| users | array | Yes | Object containing users |
UpsertExternalStorageAWSS3Request
// UpsertExternalStorageAWSS3Request array structure
[
'bucket' => string, //
'path_prefix' => string, //
'region' => string, //
'role_arn' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| bucket | string | Yes | |
| region | string | Yes | |
| role_arn | string | Yes | |
| path_prefix | string | No |
UpsertExternalStorageResponse
Basic response information
// UpsertExternalStorageResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
UpsertPushPreferencesResponse
// UpsertPushPreferencesResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'user_channel_preferences' => array, // The channel specific push notification preferences, only returned for channels you've edited.
'user_preferences' => array, // The user preferences, always returned regardless if you edited it
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| user_channel_preferences | array | Yes | The channel specific push notification preferences, only returned for channel... |
| user_preferences | array | Yes | The user preferences, always returned regardless if you edited it |
UpsertPushProviderResponse
Basic response information
// UpsertPushProviderResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'push_provider' => PushProviderResponse, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| push_provider | PushProviderResponse | Yes |
UpsertPushTemplateResponse
Basic response information
// UpsertPushTemplateResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
'template' => PushTemplateResponse, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
| template | PushTemplateResponse | No |
User
// User array structure
[
'data' => array, //
'id' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | |
| data | array | No |
UserGroupResponse
// UserGroupResponse array structure
[
'created_at' => float, //
'created_by' => string, //
'description' => string, //
'id' => string, //
'members' => array, //
'name' => string, //
'team_id' => string, //
'updated_at' => float, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| created_at | float | Yes | |
| id | string | Yes | |
| name | string | Yes | |
| updated_at | float | Yes | |
| created_by | string | No | |
| description | string | No | |
| members | array | No | |
| team_id | string | No |
UserRequest
User request object
// UserRequest array structure
[
'custom' => array, // Custom user data
'id' => string, // User ID
'image' => string, // User's profile image URL
'invisible' => bool, //
'language' => string, //
'name' => string, // Optional name of user
'privacy_settings' => PrivacySettingsResponse, //
'role' => string, // User's global role
'teams' => array, // List of teams the user belongs to
'teams_role' => array, // Map of team-specific roles for the user
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | User ID |
| custom | array | No | Custom user data |
| image | string | No | User's profile image URL |
| invisible | bool | No | |
| language | string | No | |
| name | string | No | Optional name of user |
| privacy_settings | PrivacySettingsResponse | No | |
| role | string | No | User's global role |
| teams | array | No | List of teams the user belongs to |
| teams_role | array | No | Map of team-specific roles for the user |
UserResponse
User response object
// UserResponse array structure
[
'avg_response_time' => int, //
'ban_expires' => float, // Date when ban expires
'banned' => bool, // Whether a user is banned or not
'blocked_user_ids' => array, //
'bypass_moderation' => bool, //
'created_at' => float, // Date/time of creation
'custom' => array, // Custom data for this object
'deactivated_at' => float, // Date of deactivation
'deleted_at' => float, // Date/time of deletion
'devices' => array, // List of devices user is using
'id' => string, // Unique user identifier
'image' => string, //
'invisible' => bool, //
'language' => string, // Preferred language of a user
'last_active' => float, // Date of last activity
'name' => string, // Optional name of user
'online' => bool, // Whether a user online or not
'privacy_settings' => PrivacySettingsResponse, // User privacy settings
'push_notifications' => PushNotificationSettingsResponse, // User push notification settings
'revoke_tokens_issued_before' => float, // Revocation date for tokens
'role' => string, // Determines the set of user permissions
'shadow_banned' => bool, // Whether a user is shadow banned
'teams' => array, // List of teams user is a part of
'teams_role' => array, //
'updated_at' => float, // Date/time of the last update
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| banned | bool | Yes | Whether a user is banned or not |
| blocked_user_ids | array | Yes | |
| created_at | float | Yes | Date/time of creation |
| custom | array | Yes | Custom data for this object |
| id | string | Yes | Unique user identifier |
| invisible | bool | Yes | |
| language | string | Yes | Preferred language of a user |
| online | bool | Yes | Whether a user online or not |
| role | string | Yes | Determines the set of user permissions |
| shadow_banned | bool | Yes | Whether a user is shadow banned |
| teams | array | Yes | List of teams user is a part of |
| updated_at | float | Yes | Date/time of the last update |
| avg_response_time | int | No | |
| ban_expires | float | No | Date when ban expires |
| bypass_moderation | bool | No | |
| deactivated_at | float | No | Date of deactivation |
| deleted_at | float | No | Date/time of deletion |
| devices | array | No | List of devices user is using |
| image | string | No | |
| last_active | float | No | Date of last activity |
| name | string | No | Optional name of user |
| privacy_settings | PrivacySettingsResponse | No | User privacy settings |
| push_notifications | PushNotificationSettingsResponse | No | User push notification settings |
| revoke_tokens_issued_before | float | No | Revocation date for tokens |
| teams_role | array | No |
ValidateExternalStorageResponse
Basic response information
// ValidateExternalStorageResponse array structure
[
'duration' => string, // Duration of the request in milliseconds
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| duration | string | Yes | Duration of the request in milliseconds |
VelocityFilterConfig
// VelocityFilterConfig array structure
[
'advanced_filters' => bool, //
'async' => bool, //
'cascading_actions' => bool, //
'cids_per_user' => int, //
'enabled' => bool, //
'first_message_only' => bool, //
'rules' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| advanced_filters | bool | No | |
| async | bool | No | |
| cascading_actions | bool | No | |
| cids_per_user | int | No | |
| enabled | bool | No | |
| first_message_only | bool | No | |
| rules | array | No |
VideoCallRuleConfig
// VideoCallRuleConfig array structure
[
'flag_all_labels' => bool, //
'flagged_labels' => array, //
'rules' => array, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| flag_all_labels | bool | No | |
| flagged_labels | array | No | |
| rules | array | No |
XiaomiConfig
// XiaomiConfig array structure
[
'Disabled' => bool, //
'package_name' => string, //
'secret' => string, //
]Properties:
| Property | Type | Required | Description |
|---|---|---|---|
| Disabled | bool | No | |
| package_name | string | No | |
| secret | string | No |