push_mappings

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

Overview

Name	push_mappings
Type	Resource
Id	okta.apps.push_mappings

Fields

The following fields are returned by SELECT queries:

list_group_push_mappings

Name	Datatype	Description
id	string	The ID of the group push mapping
_links	object	Discoverable resources related to the group push mapping
appConfig	object	Additional app configuration for group push mappings. Currently only required for Active Directory.
created	string (date-time)	Timestamp when the group push mapping was created
errorSummary	string	The error message summary if the latest push failed
lastPush	string (date-time)	Timestamp when the group push mapping was pushed
lastUpdated	string (date-time)	Timestamp when the group push mapping was last updated
sourceGroupId	string	The ID of the source group for the group push mapping
status	string	The status of the group push mapping
targetGroupId	string	The ID of the target group for the group push mapping

get_group_push_mapping

Name	Datatype	Description
id	string	The ID of the group push mapping
_links	object	Discoverable resources related to the group push mapping
appConfig	object	Additional app configuration for group push mappings. Currently only required for Active Directory.
created	string (date-time)	Timestamp when the group push mapping was created
errorSummary	string	The error message summary if the latest push failed
lastPush	string (date-time)	Timestamp when the group push mapping was pushed
lastUpdated	string (date-time)	Timestamp when the group push mapping was last updated
sourceGroupId	string	The ID of the source group for the group push mapping
status	string	The status of the group push mapping
targetGroupId	string	The ID of the target group for the group push mapping

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_group_push_mappings	select	subdomain	after, limit, lastUpdated, sourceGroupId, status	Lists all group push mappings with pagination support
get_group_push_mapping	select	subdomain		Retrieves a group push mapping by ID
create_group_push_mapping	insert	subdomain, data__sourceGroupId		Creates or links a group push mapping. Note: Either targetGroupId or targetGroupName must be provided, but not both. If targetGroupId is provided, it links to an existing group. If targetGroupName is provided, it creates a new group.
update_group_push_mapping	update	subdomain, data__status		Updates the status of a group push mapping
delete_group_push_mapping	delete	deleteTargetGroup, subdomain		Deletes a specific group push mapping. The group push mapping must be in an INACTIVE state.

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
deleteTargetGroup	boolean	If set to true, the target group is also deleted. If set to false, the target group isn't deleted.
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)
after	string	Specifies the pagination cursor for the next page of mappings
lastUpdated	string	Filters group push mappings by last updated date. The lastUpdated parameter supports the following format: YYYY-MM-DDTHH:mm:ssZ. This filters mappings updated on or after the specified date and time in UTC. If you don't specify a value, all group push mappings are returned.
limit	integer (int32)	Specifies the number of results returned
sourceGroupId	string	Filters group push mappings by source group ID. If you don't specify a value, all group push mappings are returned.
status	string	Filters group push mappings by status. If you don't specify a value, all group push mappings are returned.

SELECT examples

list_group_push_mappings

Lists all group push mappings with pagination support

SELECT
id,
_links,
appConfig,
created,
errorSummary,
lastPush,
lastUpdated,
sourceGroupId,
status,
targetGroupId
FROM okta.apps.push_mappings
WHERE subdomain = '{{ subdomain }}' -- required
AND after = '{{ after }}'
AND limit = '{{ limit }}'
AND lastUpdated = '{{ lastUpdated }}'
AND sourceGroupId = '{{ sourceGroupId }}'
AND status = '{{ status }}';

get_group_push_mapping

Retrieves a group push mapping by ID

SELECT
id,
_links,
appConfig,
created,
errorSummary,
lastPush,
lastUpdated,
sourceGroupId,
status,
targetGroupId
FROM okta.apps.push_mappings
WHERE subdomain = '{{ subdomain }}' -- required;

INSERT examples

create_group_push_mapping

Creates or links a group push mapping.

Note: Either targetGroupId or targetGroupName must be provided, but not both. If targetGroupId is provided, it links to an existing group. If targetGroupName is provided, it creates a new group.

INSERT INTO okta.apps.push_mappings (
data__appConfig,
data__sourceGroupId,
data__status,
data__targetGroupId,
data__targetGroupName,
subdomain
)
SELECT 
'{{ appConfig }}',
'{{ sourceGroupId }}' --required,
'{{ status }}',
'{{ targetGroupId }}',
'{{ targetGroupName }}',
'{{ subdomain }}'
RETURNING
id,
_links,
appConfig,
created,
errorSummary,
lastPush,
lastUpdated,
sourceGroupId,
status,
targetGroupId
;

Manifest

# Description fields are for documentation purposes
- name: push_mappings
  props:
    - name: subdomain
      value: string
      description: Required parameter for the push_mappings resource.
    - name: appConfig
      value: object
      description: >
        Additional app configuration for group push mappings. Currently only required for Active Directory.
        
    - name: sourceGroupId
      value: string
      description: >
        The ID of the source group for the group push mapping
        
    - name: status
      value: string
      description: >
        The status of the group push mapping
        
      valid_values: ['ACTIVE', 'INACTIVE']
      default: ACTIVE
    - name: targetGroupId
      value: string
      description: >
        The ID of the existing target group for the group push mapping. This is used to link to an existing group. Required if `targetGroupName` is not provided.
        
    - name: targetGroupName
      value: string
      description: >
        The name of the target group for the group push mapping. This is used when creating a new downstream group. If the group already exists, it links to the existing group. Required if `targetGroupId` is not provided.
        

UPDATE examples

update_group_push_mapping

Updates the status of a group push mapping

UPDATE okta.apps.push_mappings
SET 
data__status = '{{ status }}'
WHERE 
subdomain = '{{ subdomain }}' --required
AND data__status = '{{ status }}' --required
RETURNING
id,
_links,
appConfig,
created,
errorSummary,
lastPush,
lastUpdated,
sourceGroupId,
status,
targetGroupId;

DELETE examples

delete_group_push_mapping

Deletes a specific group push mapping. The group push mapping must be in an INACTIVE state.

DELETE FROM okta.apps.push_mappings
WHERE deleteTargetGroup = '{{ deleteTargetGroup }}' --required
AND subdomain = '{{ subdomain }}' --required;