v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1483595482.8 KB

Subscribes an IAM Identity Center user or a group to a pricing tier for an Amazon Q Business application.

Amazon Q Business offers two subscription tiers: Q_LITE and Q_BUSINESS. Subscription tier determines feature access for the user. For more information on subscriptions and pricing tiers, see Amazon Q Business pricing.

For an example IAM role policy for assigning subscriptions, see Set up required permissions in the Amazon Q Business User Guide.

post/applications/{applicationId}/subscriptions

Path parameters

applicationIdstring required

The identifier of the Amazon Q Business application the subscription should be added to.

Request body

type'Q_LITE' | 'Q_BUSINESS' required

The type of Amazon Q Business subscription you want to create.

clientTokenstring

A token that you provide to identify the request to create a subscription for your Amazon Q Business application.

Response

Success

subscriptionIdstring

The identifier of the Amazon Q Business subscription created.

subscriptionArnstring

The Amazon Resource Name (ARN) of the Amazon Q Business subscription created.