---
title: "Get App Settings"
method: GET
path: "/app"
tags: ["product:chat"]
---

# Get App Settings

`GET /app`

This Method returns the application settings

## Response `200`

Response

- GetApplicationResponse, nullable — Basic response information
  - `app` AppResponseFields, required
    - `activity_metrics_config` object
    - `allow_multi_user_devices` boolean, required
    - `allowed_flag_reasons` string[]
    - `async_url_enrich_enabled` boolean, required
    - `auto_translation_enabled` boolean, required
    - `before_message_send_hook_attempt_timeout_ms` integer
    - `before_message_send_hook_url` string
    - `call_types` object, required
    - `campaign_enabled` boolean, required
    - `cdn_expiration_seconds` integer, required
    - `channel_configs` object, required
    - `chat_primary_use_case` string
    - `custom_action_handler_url` string, required
    - `datadog_info` DataDogInfo
      - `api_key` string
      - `enabled` boolean
      - `site` string
    - `disable_auth_checks` boolean, required
    - `disable_permissions_checks` boolean, required
    - `enforce_unique_usernames` string, required
    - `event_hooks` EventHook[], required
      - `callback` AsyncModerationCallbackConfig
        - `mode` 'CALLBACK_MODE_NONE' | 'CALLBACK_MODE_REST' | 'CALLBACK_MODE_TWIRP'
        - `server_url` string
      - `created_at` string, date-time
      - `enabled` boolean
      - `event_types` string[]
      - `failover_config` WebhookFailoverConfig
        - `gcs_bucket` string
        - `gcs_credentials` string
        - `gcs_path` string
        - `type` string
      - `hook_type` string
      - `id` string
      - `product` string
      - `should_send_custom_events` boolean
      - `sns_auth_type` string
      - `sns_event_based_message_group_id_enabled` boolean
      - `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` integer
      - `updated_at` string, date-time
      - `webhook_url` string
    - `feed_audit_logs_enabled` boolean, required
    - `file_upload_config` FileUploadConfig, required
      - `allowed_file_extensions` string[]
      - `allowed_mime_types` string[]
      - `blocked_file_extensions` string[]
      - `blocked_mime_types` string[]
      - `size_limit` integer, required
    - `geofences` GeofenceResponse[]
      - `country_codes` string[]
      - `description` string
      - `name` string, required
      - `type` string
    - `grants` object, required
    - `guest_user_creation_disabled` boolean, required
    - `id` integer, required
    - `image_moderation_enabled` boolean, required
    - `image_moderation_labels` string[]
    - `image_upload_config` FileUploadConfig, required
      - `allowed_file_extensions` string[]
      - `allowed_mime_types` string[]
      - `blocked_file_extensions` string[]
      - `blocked_mime_types` string[]
      - `size_limit` integer, required
    - `max_aggregated_activities_length` integer, required
    - `member_custom_on_mentioned_users_enabled` boolean, required
    - `member_custom_on_messages_enabled` boolean, required
    - `moderation_audio_call_moderation_enabled` boolean, required
    - `moderation_dashboard_preferences` ModerationDashboardPreferences
      - `allowed_moderation_action_reasons` string[]
      - `async_review_queue_upsert` boolean
      - `block_foreign_cdn_attachments` boolean
      - `custom_views_enabled` boolean
      - `disable_audit_logs` boolean
      - `disable_flagging_reviewed_entity` boolean
      - `escalation_queue_enabled` boolean
      - `escalation_reasons` string[]
      - `filterable_custom_keys` string[]
      - `flag_user_on_flagged_content` boolean
      - `include_attachment_payload` boolean
      - `keyframe_classifications_map` object
      - `media_queue_blur_enabled` boolean
      - `overview_dashboard` OverviewDashboardConfig
        - `default_date_range_days` integer
        - `visible_charts` string[]
    - `moderation_enabled` boolean, required
    - `moderation_llm_configurability_enabled` boolean, required
    - `moderation_multitenant_blocklist_enabled` boolean, required
    - `moderation_onboarding_complete` boolean
    - `moderation_s3_image_access_role_arn` string
    - `moderation_video_call_moderation_enabled` boolean, required
    - `moderation_webhook_url` string, required
    - `multi_tenant_enabled` boolean, required
    - `name` string, required
    - `organization` string, required
    - `permission_version` string, required
    - `placement` string, required
    - `policies` object, required
    - `push_notifications` PushNotificationFields, required
      - `apn` APNConfigFields, required
        - `auth_key` string
        - `auth_type` string
        - `bundle_id` string
        - `development` boolean, required
        - `enabled` boolean, required
        - `host` string
        - `key_id` string
        - `notification_template` string
        - `p12_cert` string
        - `team_id` string
      - `firebase` FirebaseConfigFields, required
        - `apn_template` string
        - `credentials_json` string
        - `data_template` string
        - `enabled` boolean, required
        - `notification_template` string
        - `server_key` string
      - `huawei` HuaweiConfigFields, required
        - `enabled` boolean, required
        - `id` string
        - `secret` string
      - `offline_only` boolean, required
      - `providers` PushProvider[]
        - `apn_auth_key` string
        - `apn_auth_type` string
        - `apn_development` boolean
        - `apn_host` string
        - `apn_key_id` string
        - `apn_notification_template` string
        - `apn_p12_cert` string
        - `apn_team_id` string
        - `apn_topic` string
        - `created_at` string, date-time, required
        - `description` string
        - `disabled_at` string, date-time
        - `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, required
        - `push_templates` PushTemplate[]
          - `created_at` string, date-time, required
          - `enable_push` boolean, required
          - `event_type` 'message.new' | 'message.updated' | 'reaction.new' | 'notification.reminder_due' | 'feeds.activity.added' | 'feeds.comment.added' | 'feeds.activity.reaction.added' | 'feeds.comment.reaction.added' | 'feeds.follow.created' | 'feeds.notification_feed.updated', required
          - `template` string
          - `updated_at` string, date-time, required
        - `type` string, required
        - `updated_at` string, date-time, required
        - `xiaomi_app_secret` string
        - `xiaomi_package_name` string
      - `version` string, required
      - `xiaomi` XiaomiConfigFields, required
        - `enabled` boolean, required
        - `package_name` string
        - `secret` string
    - `reminders_interval` integer, required
    - `revoke_tokens_issued_before` string, date-time
    - `sns_key` string, required
    - `sns_secret` string, required
    - `sns_topic_arn` string, required
    - `sqs_key` string, required
    - `sqs_secret` string, required
    - `sqs_url` string, required
    - `suspended` boolean, required
    - `suspended_explanation` string, required
    - `use_hook_v2` boolean, required
    - `user_response_time_enabled` boolean, required
    - `user_search_disallowed_roles` string[], required
    - `video_primary_use_case` string
    - `webhook_events` string[], required
    - `webhook_url` string, required
  - `duration` string, required — Duration of the request in milliseconds

## Other responses

- `400` — Bad request
- `429` — Too many requests

## Changes

> 108 revisions in range; 2 not diffed, 2 could not be searched.

- **2026-08-20** `ff38012a3de8` — 1 info
  - added the required property `app/channel_configs/additionalProperties/message_retention` to the response with the `200` status
- **2026-08-11** `6e00e4be12e0` — 1 breaking
  - removed the required property `app/moderation_flood_rules_enabled` from the response with the `200` status
- **2026-08-07** `daa9e7b85096` — 1 info
  - added the required property `app/member_custom_on_messages_enabled` to the response with the `200` status
- **2026-07-29** `d274674f0337` — 1 breaking, 2 warning, 40 info
  - the response property `app/channel_configs/additionalProperties/` became nullable for the status `200`
  - removed the optional property `app/channel_configs/additionalProperties/grants` from the response with the `200` status
  - added the new `shadow_block` enum value to the `app/channel_configs/additionalProperties/blocklist_behavior` response property for the response status `200`
  - added the optional property `app/before_message_send_hook_attempt_timeout_ms` to the response with the `200` status
  - …39 more

[Change history](https://skmtc.dev/getstream/apis/stream-api/changes/app/get.md)

---

[API](https://skmtc.dev/getstream/apis/stream-api.md) · [All operations](https://skmtc.dev/getstream/apis/stream-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getstream/stream-api/revisions/653d3d10a523/schema)