# API data types for AppFabric for productivity (preview) | | | --- | | The AWS AppFabric for productivity feature is in preview and is subject to change. | The AppFabric API contains several data types that various actions use. This section describes the data types for the AppFabric for productivity features in detail. For all other AppFabric API data types, see the [AWS AppFabric API Data Types](https://docs.aws.amazon.com/appfabric/latest/api/API_Types.html). **Important** The order of each element in a data type structure is not guaranteed. Applications should not assume a particular order. **Topics** + [ActionableInsights](API_ActionableInsights.md) + [AppClient](API_AppClient.md) + [AppClientSummary](API_AppClientSummary.md) + [MeetingInsights](API_MeetingInsights.md) + [VerificationDetails](API_VerificationDetails.md) # ActionableInsights | | | --- | | The AWS AppFabric for productivity feature is in preview and is subject to change. | Contains a summary of important and suitable actions for a user based on emails, calendar invites, messages, and tasks from their app portfolio. Users can see proactive insights from across their applications to help them best orient their day. These insights provide justification on why a user should care about the insight summary along with references, such as embedded links, to individual apps and artifacts that generated the insight. | Parameter | Description | | --- | --- | | **insightId** | The unique id for the generated insight. | | **insightContent** | This returns a summary of the insight and embedded links to artifacts used to generate the insight. This would be an HTML content containing embedded links (`` tags). | | **insightTitle** | The title of the generated insight. | | **createdAt** | When the insight was generated. | | **actions** | A list of actions recommend for the generated insight. The action object contains the following parameters: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appfabric/latest/adminguide/API_ActionableInsights.html) | # AppClient | | | --- | | The AWS AppFabric for productivity feature is in preview and is subject to change. | Contains information about an AppClient. **Topics** | Parameter | Description | | --- | --- | | **appName** | The name of the application. Type: String Required: Yes | | **arn** | The Amazon Resource Name (ARN) of the AppClient. Type: String Length Constraints: Minimum length of 1. Maximum length of 1011. Pattern: `arn:.+` Required: Yes | | **description** | A description for the application. Type: String Required: Yes | | **iconUrl** | The URL to the icon or logo for the AppClient. Type: String Required: No | | **redirectUrls** | The allowed redirect URLs for the AppClient. Type: Array of strings Array Members: Minimum number of 1 item. Maximum number of 5 items. Length Constraints: Minimum length of 1. Maximum length of 2048. Pattern: `(http\|https):\/\/[-a-zA-Z0-9_:.\/]+` Required: Yes | | **starterUserEmails** | Starter email addresses for users who are allowed access to receive insights until the AppClient is verified. Type: Array of strings Array Members: Fixed number of 1 item. Length Constraints: Minimum length of 0. Maximum length of 320. Pattern: `[a-zA-Z0-9.!#$%&’*+/=?^_`{\|}~-]+@[a-zA-Z0-9-]+(?:\.[a-zA-Z0-9-]+)*` Required: Yes | | **verificationDetails** | Contains the status and reason for the AppClient verification. Type: [VerificationDetails](API_VerificationDetails.md) object Required: Yes | | **customerManagedKeyArn** | The Amazon Resource Name (ARN) of the customer managed key generated by AWS Key Management Service for the AppClient. Type: String Length Constraints: Minimum length of 1. Maximum length of 1011. Pattern: `arn:.+` Required: No | | **appClientId** | The ID of the AppClient. Meant to be used in o-auth flows for the app-client. Type: String Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Required: No | # AppClientSummary | | | --- | | The AWS AppFabric for productivity feature is in preview and is subject to change. | Contains information about an AppClient. **Topics** | Parameter | Description | | --- | --- | | **arn** | The Amazon Resource Name (ARN) of the AppClient. Type: String Length Constraints: Minimum length of 1. Maximum length of 1011. Pattern: `arn:.+` Required: Yes | | **verificationStatus** | The AppClient verification status. Type: String Valid Values: `pending_verification \| verified \| rejected` Required: Yes | | **appClientId** | The ID of the AppClient. Meant to be used in o-auth flows for the app-client. Type: String Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Required: No | # MeetingInsights | | | --- | | The AWS AppFabric for productivity feature is in preview and is subject to change. | Contains a summary of the top 3 meetings along with meeting purpose, related cross-app artifacts, and activities from tasks, emails, messages, and calendar events. | Parameter | Description | | --- | --- | | **insightId** | The unique id for the generated insight. | | **insightContent** | The description of the insight highlighting the details in a string format. As in, why is this insight important. | | **insightTitle** | The title of the generated insight. | | **createdAt** | When the insight was generated. | | **calendarEvent** | The important calendar event or meeting that the user should focus on. Calendar Event object: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appfabric/latest/adminguide/API_MeetingInsights.html) | | **resources** | The list containing the other resources related to the generate the insight. Resource object: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/appfabric/latest/adminguide/API_MeetingInsights.html) | | **nextToken** | The pagination token to fetch the next set of insights. It’s an optional field which if returned null means there are no more insights to load. | # VerificationDetails | | | --- | | The AWS AppFabric for productivity feature is in preview and is subject to change. | Contains the status and reason for the AppClient verification. **Topics** | Parameter | Description | | --- | --- | | **verificationStatus** | The AppClient verification status. Type: String Valid Values: `pending_verification \| verified \| rejected` Required: Yes | | **statusReason** | The AppClient verification status reason. Type: String Length Constraints: Minimum length of 1. Maximum length of 1024. Required: No |