subscriptions

Creates, updates, deletes, gets or lists a subscriptions resource.

Overview

Name	subscriptions
Type	Resource
Id	okta.roles.subscriptions

Fields

The following fields are returned by SELECT queries:

list_subscriptions_role

Name	Datatype	Description
_links	object	Discoverable resources related to the subscription
channels	array	An array of sources send notifications to users. > Note: Currently, Okta only allows email channels.
notificationType	string	The type of notification
status	string	The status of the subscription

get_subscriptions_notification_type_role

Name	Datatype	Description
_links	object	Discoverable resources related to the subscription
channels	array	An array of sources send notifications to users. > Note: Currently, Okta only allows email channels.
notificationType	string	The type of notification
status	string	The status of the subscription

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_subscriptions_role	select	subdomain		Lists all subscriptions available to a specified Role
get_subscriptions_notification_type_role	select	subdomain		Retrieves a subscription by notificationType for a specified Role
subscribe_by_notification_type_role	exec	subdomain		Subscribes a Role to a specified notification type. Changes to Role subscriptions override the subscription status of any individual users with the Role.
unsubscribe_by_notification_type_role	exec	subdomain		Unsubscribes a Role from a specified notification type. Changes to Role subscriptions override the subscription status of any individual users with the Role.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
subdomain	string	The domain of your organization. This can be a provided subdomain of an official okta domain (okta.com, oktapreview.com, etc) or one of your configured custom domains. (default: my-org)

SELECT examples

list_subscriptions_role

Lists all subscriptions available to a specified Role

SELECT
_links,
channels,
notificationType,
status
FROM okta.roles.subscriptions
WHERE subdomain = '{{ subdomain }}' -- required;

get_subscriptions_notification_type_role

Retrieves a subscription by notificationType for a specified Role

SELECT
_links,
channels,
notificationType,
status
FROM okta.roles.subscriptions
WHERE subdomain = '{{ subdomain }}' -- required;

Lifecycle Methods

subscribe_by_notification_type_role

Subscribes a Role to a specified notification type. Changes to Role subscriptions override the subscription status of any individual users with the Role.

EXEC okta.roles.subscriptions.subscribe_by_notification_type_role 
@subdomain='{{ subdomain }}' --required;

unsubscribe_by_notification_type_role

Unsubscribes a Role from a specified notification type. Changes to Role subscriptions override the subscription status of any individual users with the Role.

EXEC okta.roles.subscriptions.unsubscribe_by_notification_type_role 
@subdomain='{{ subdomain }}' --required;