# API actions for AppFabric for productivity (preview)
| |
| --- |
| The AWS AppFabric for productivity feature is in preview and is subject to change. |
The following actions are supported for the AppFabric for productivity features.
For all other AppFabric API actions, see the [AWS AppFabric API Actions](https://docs.aws.amazon.com/appfabric/latest/api/API_Operations.html).
**Topics**
+ [Authorize](API_Authorize.md)
+ [CreateAppClient](API_CreateAppClient.md)
+ [DeleteAppClient](API_DeleteAppClient.md)
+ [GetAppClient](API_GetAppClient.md)
+ [ListActionableInsights](API_ListActionableInsights.md)
+ [ListAppClients](API_ListAppClients.md)
+ [ListMeetingInsights](API_ListMeetingInsights.md)
+ [PutFeedback](API_PutFeedback.md)
+ [Token](API_Token.md)
+ [UpdateAppClient](API_UpdateAppClient.md)
# Authorize
| |
| --- |
| The AWS AppFabric for productivity feature is in preview and is subject to change. |
Authorizes an AppClient.
**Topics**
+ [Request body](#API_Authorize_request)
## Request body
The request accepts the following data in JSON format.
| Parameter | Description |
| --- | --- |
| **app\$1client\$1id** | The ID of the AppClient to authorize. |
| **redirect\$1uri** | The URI to redirect end users to after authorization. |
| **state** | A unique value to maintain the state between the request and callback. |
# CreateAppClient
| |
| --- |
| The AWS AppFabric for productivity feature is in preview and is subject to change. |
Creates an AppClient.
**Topics**
+ [Request body](#API_CreateAppClient_request)
+ [Response elements](#API_CreateAppClient_response)
## Request body
The request accepts the following data in JSON format.
| Parameter | Description |
| --- | --- |
| **appName** | The name of the app. Type: String Length Constraints: Minimum length of 1. Maximum length of 255. Required: Yes |
| **clientToken** | Specifies a unique, case-sensitive identifier that you provide to ensure the idempotency of the request. This lets you safely retry the request without accidentally performing the same operation a second time. Passing the same value to a later call to an operation requires that you also pass the same value for all other parameters. We recommend that you use a [UUID type of value](https://wikipedia.org/wiki/Universally_unique_identifier). If you don't provide this value, then AWS generates a random one for you. If you retry the operation with the same `ClientToken`, but with different parameters, the retry fails with an `IdempotentParameterMismatch` error. 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 |
| **customerManagedKeyIdentifier** | The ARN of the customer managed key generated by AWS Key Management Service. The key is used to encrypt the data. If no key is specified, then an AWS managed key is used. A map of the key-value pairs of the tag or tags to assign to the resource. For more information about AWS owned keys and customer managed keys, see [Customer keys and AWS keys](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#key-mgmt) in the *AWS Key Management Service Developer Guide*. Type: String Length Constraints: Minimum length of 1. Maximum length of 1011. Pattern: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Required: No |
| **description** | A description for the app. Type: String Required: Yes |
| **iconUrl** | The URL to the icon or logo for the AppClient. Type: String Required: No |
| **redirectUrls** | The URI to redirect end users to after authorization. You can add up to 5 redirectUrls. For example, `https://localhost:8080`. 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 |
| **tags** | A map of the key-value pairs of the tag or tags to assign to the resource. Type: Array of Tag objects Array Members: Minimum number of 0 items. Maximum number of 50 items. Required: No |
## Response elements
If the action is successful, the service sends back an HTTP 201 response.
The following data is returned in JSON format by the service.
| Parameter | Description |
| --- | --- |
| **appClientSummary** | Contains a summary of the AppClient. Type: [AppClientSummary](API_AppClientSummary.md) object |
# DeleteAppClient
| |
| --- |
| The AWS AppFabric for productivity feature is in preview and is subject to change. |
Deletes an application client.
**Topics**
+ [Request body](#API_DeleteAppClient_request)
+ [Response elements](#API_DeleteAppClient_response)
## Request body
The request accepts the following data in JSON format.
| Parameter | Description |
| --- | --- |
| **appClientIdentifier** | The Amazon Resource Name (ARN) or Universal Unique Identifier (UUID) of the AppClient to use for the request. Length Constraints: Minimum length of 1. Maximum length of 1011. Pattern: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Required: Yes |
## Response elements
If the action is successful, the service sends back an HTTP 204 response with an empty HTTP body.
# GetAppClient
| |
| --- |
| The AWS AppFabric for productivity feature is in preview and is subject to change. |
Returns information about an AppClient.
**Topics**
+ [Request body](#API_GetAppClient_request)
+ [Response elements](#API_GetAppClient_response)
## Request body
The request accepts the following data in JSON format.
| Parameter | Description |
| --- | --- |
| **appClientIdentifier** | The Amazon Resource Name (ARN) or Universal Unique Identifier (UUID) of the AppClient to use for the request. Length Constraints: Minimum length of 1. Maximum length of 1011. Pattern: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Required: Yes |
## Response elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
| Parameter | Description |
| --- | --- |
| **appClient** | Contains information about an AppClient. Type: [AppClient](API_AppClient.md) object |
# ListActionableInsights
| |
| --- |
| The AWS AppFabric for productivity feature is in preview and is subject to change. |
Lists the most important actionable email messages, tasks, and other updates.
**Topics**
+ [Request body](#API_ListActionableInsights_request)
+ [Response elements](#API_ListActionableInsights_response)
## Request body
The request accepts the following data in JSON format.
| Parameter | Description |
| --- | --- |
| **nextToken** | If `nextToken` is returned, there are more results available. The value of `nextToken` is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an *HTTP 400 InvalidToken error*. |
## Response elements
If the action is successful, the service sends back an HTTP 201 response.
The following data is returned in JSON format by the service.
| Parameter | Description |
| --- | --- |
| **ActionableInsightsList** | Lists the actionable insights, including a title, description, actions, and created timestamp. For more information, see [ActionableInsights](API_ActionableInsights.md). |
| **nextToken** | If `nextToken` is returned, there are more results available. The value of `nextToken` is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an *HTTP 400 InvalidToken error*. Type: String |
# ListAppClients
| |
| --- |
| The AWS AppFabric for productivity feature is in preview and is subject to change. |
Returns a list of all AppClients.
**Topics**
+ [Request body](#API_ListAppClients_request)
+ [Response elements](#API_ListAppClients_response)
## Request body
The request accepts the following data in JSON format.
| Parameter | Description |
| --- | --- |
| **maxResults** | The maximum number of results that are returned per call. You can use `nextToken` to obtain further pages of results. This is only an upper limit. The actual number of results returned per call might be fewer than the specified maximum. Valid Range: Minimum value of 1. Maximum value of 100. |
| **nextToken** | If `nextToken` is returned, there are more results available. The value of `nextToken` is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an *HTTP 400 InvalidToken error*. |
## Response elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
| Parameter | Description |
| --- | --- |
| **appClientList** | Contains a list of AppClient results. Type: Array of [AppClientSummary](API_AppClientSummary.md) objects |
| **nextToken** | If `nextToken` is returned, there are more results available. The value of `nextToken` is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an *HTTP 400 InvalidToken error*. Type: String |
# ListMeetingInsights
| |
| --- |
| The AWS AppFabric for productivity feature is in preview and is subject to change. |
Lists the most important actionable calendar events.
**Topics**
+ [Request body](#API_ListMeetingInsights_request)
+ [Response elements](#API_ListMeetingInsights_response)
## Request body
The request accepts the following data in JSON format.
| Parameter | Description |
| --- | --- |
| **nextToken** | If `nextToken` is returned, there are more results available. The value of `nextToken` is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an *HTTP 400 InvalidToken error*. |
## Response elements
If the action is successful, the service sends back an HTTP 201 response.
The following data is returned in JSON format by the service.
| Parameter | Description |
| --- | --- |
| **MeetingInsightList** | Lists the actionable meeting insights. For more information, see [MeetingInsights](API_MeetingInsights.md). |
| **nextToken** | If `nextToken` is returned, there are more results available. The value of `nextToken` is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged. Each pagination token expires after 24 hours. Using an expired pagination token will return an *HTTP 400 InvalidToken error*. Type: String |
# PutFeedback
| |
| --- |
| The AWS AppFabric for productivity feature is in preview and is subject to change. |
Allows users to submit feedback for a given insight or action.
**Topics**
+ [Request body](#API_PutFeedback_request)
+ [Response elements](#API_PutFeedback_response)
## Request body
The request accepts the following data in JSON format.
| Parameter | Description |
| --- | --- |
| **id** | The ID of the object for which feedback is being submitted. This can be either the InsightId or the ActionId. |
| **feedbackFor** | The insight type for which the feedback is being submitted. Possible values: `ACTIONABLE_INSIGHT \| MEETING_INSIGHT \| ACTION` |
| **feedbackRating** | Feedback Rating from `1` to `5`. Higher rating the better. |
## Response elements
If the action is successful, the service sends back an HTTP 201 response with an empty HTTP body.
# Token
| |
| --- |
| The AWS AppFabric for productivity feature is in preview and is subject to change. |
Contains information that allows AppClients to exchange an authorization code for an access token.
**Topics**
+ [Request body](#API_Token_request)
+ [Response elements](#API_Token_response)
## Request body
The request accepts the following data in JSON format.
| Parameter | Description |
| --- | --- |
| **code** | The authorization code received from the authorization endpoint. Type: String Length Constraints: Minimum length of 1. Maximum length of 2048. Required: No |
| **grant\$1type** | The grant type for the token. Must be either `authorization_code` or `refresh_token`. Type: String Required: Yes |
| **app\$1client\$1id** | The ID of the AppClient. Type: String Pattern: `[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Required: Yes |
| **redirect\$1uri** | The redirect URI passed to the authorization endpoint. Type: String Required: No |
| **refresh\$1token** | The refresh token received from the initial token request. Type: String Length Constraints: Minimum length of 1. Maximum length of 4096. Required: No |
## Response elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
| Parameter | Description |
| --- | --- |
| **appfabric\$1user\$1id** | The ID of the user for the token. This is returned only for requests that use the `authorization_code` grant type. Type: String |
| **expires\$1in** | The number of seconds until the token expires. Type: Long |
| **refresh\$1token** | The refresh token to use for a subsequent request. Type: String Length Constraints: Minimum length of 1. Maximum length of 2048. |
| **token** | The access token. Type: String Length Constraints: Minimum length of 1. Maximum length of 2048. |
| **token\$1type** | The token type. Type: String |
# UpdateAppClient
| |
| --- |
| The AWS AppFabric for productivity feature is in preview and is subject to change. |
Updates an AppClient.
**Topics**
+ [Request body](#API_UpdateAppClient_request)
+ [Response elements](#API_UpdateAppClient_response)
## Request body
The request accepts the following data in JSON format.
| Parameter | Description |
| --- | --- |
| **appClientIdentifier** | The Amazon Resource Name (ARN) or Universal Unique Identifier (UUID) of the AppClient to use for the request. Length Constraints: Minimum length of 1. Maximum length of 1011. Pattern: `arn:.+$\|^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}` Required: Yes |
| **redirectUrls** | The URI to redirect end users to after authorization. You can add up to 5 redirectUrls. For example, `https://localhost:8080`. 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_:.\/]+` |
## Response elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
| Parameter | Description |
| --- | --- |
| **appClient** | Contains information about an AppClient. Type: [AppClient](API_AppClient.md) object |