Create Revision

POST {{apiPath}}/environments/{{envID}}/propagation/revisions

The POST /environments/{{envID}}/propagation/revisions endpoint creates a new propagation configuration that captures a snapshot of the current identity propagation plan, store, rule, and mapping settings associated with the specified environment resource.

This POST does not require a request body.

Note: When you create a new revision, the create event automatically initiates identity store resynchronization. For large sets of identities, this process can take a while to complete.

Prerequisites

RESPONSES

status: Created

{"id":"34c2aa20-74b8-11ec-ba2d-8101b6722565","environment":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"previousRevision":{"id":"a20a7660-74b5-11ec-a963-b37d330ca94f"},"createdAt":"2022-01-13T21:31:44.962Z","_links":{"latest":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/propagation/revisions/id:latest"},"create":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/propagation/revisions"},"previous":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/propagation/revisions/a20a7660-74b5-11ec-a963-b37d330ca94f"}},"_embedded":{"plans":[{"id":"ea142a22-61d8-4df7-a93e-8de943c526fe","environment":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"name":"Default Plan","_links":{"self":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/propagation/plans/ea142a22-61d8-4df7-a93e-8de943c526fe"}},"_embedded":{"rules":[{"id":"f9d4c0fc-269d-4645-9079-2795b18f06a6","environment":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"createdAt":"2022-01-13T20:37:29.220Z","updatedAt":"2022-01-13T20:37:29.220Z","plan":{"id":"ea142a22-61d8-4df7-a93e-8de943c526fe"},"sourceStore":{"id":"a7115f69-136d-4b5d-8b24-5c1c218147f5"},"targetStore":{"id":"9f95941f-9870-448c-9ff6-2a132e4b5d5a"},"active":false,"deprovision":true,"populations":[{"id":"cb3ef0a0-0ff5-4f60-ae82-4ae65d9d0e3a"}],"_links":{"self":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/propagation/rules/f9d4c0fc-269d-4645-9079-2795b18f06a6"},"targetStore":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/propagation/stores/9f95941f-9870-448c-9ff6-2a132e4b5d5a"},"sourceStore":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/propagation/stores/a7115f69-136d-4b5d-8b24-5c1c218147f5"},"plan":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/propagation/plans/ea142a22-61d8-4df7-a93e-8de943c526fe"}},"_embedded":{"mappings":[]}}]}}],"stores":[{"id":"3277e244-ccc7-4d98-b313-22c38a5c7d35","environment":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"createdAt":"2022-01-13T21:31:35.985Z","updatedAt":"2022-01-13T21:31:35.985Z","image":{},"type":"Salesforce","status":"INACTIVE","configuration":{"FREEZE_USER_FLAG":false,"ENABLE_COMMUNITIES":true,"PERMISSION_SET_MANAGEMENT":"Merge with permission sets in Salesforce","CREATE_NEW_USERS":true,"UPDATE_NEW_USERS":true,"DISABLE_USERS":true,"PROVISION_DISABLED_USERS":true,"SALESFORCE_DOMAIN":"https://example.com","CLIENT_ID":"fdsfd","CLIENT_SECRET":"fdsafds","OAUTH_ACCESS_TOKEN":"fdsfds","OAUTH_REFRESH_TOKEN":"fdsfdsa"},"name":"test","_links":{"self":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/propagation/stores/3277e244-ccc7-4d98-b313-22c38a5c7d35"}}},{"id":"9f95941f-9870-448c-9ff6-2a132e4b5d5a","environment":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"createdAt":"2022-01-10T21:13:01.061Z","updatedAt":"2022-01-10T21:13:01.061Z","image":{"href":"https://d1oekt4jpdthse.cloudfront.net/branding/market/cb933bfe-8282-405a-a780-0a19b97edc02.png"},"type":"Aquera","status":"INACTIVE","configuration":{"AUTHENTICATION_METHOD":"None","USER_FILTER":"username Eq \"%s\"","UNIQUE_USER_IDENTIFIER":"userName","REMOVE_ACTION":"Disable","CREATE_NEW_USERS":true,"UPDATE_NEW_USERS":true,"DISABLE_NEW_USERS":true,"USERS_RESOURCE":"/Users","SCIM_VERSION":"2.0","SCIM_URL":"https://example.com","AUTHORIZATION_TYPE":"Basic","BASIC_AUTH_USER":"basicUserName","BASIC_AUTH_PASSWORD":"$3cr3t_p@55w0rd"},"name":"AqueraTest","_links":{"self":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/propagation/stores/9f95941f-9870-448c-9ff6-2a132e4b5d5a"}}},{"id":"a7115f69-136d-4b5d-8b24-5c1c218147f5","environment":{"id":"abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6"},"createdAt":"2022-01-10T17:32:21.502Z","updatedAt":"2022-01-10T20:29:55.593Z","image":{"href":"https://d1oekt4jpdthse.cloudfront.net/branding/market/cb933bfe-8282-405a-a780-0a19b97edc02.png"},"description":"Update a scim connection","type":"scim","configuration":{"AUTHENTICATION_METHOD":"Basic Authentication","SCIM_URL":"https://scim.url","USERS_RESOURCE":"/users","SCIM_VERSION":"1.1","AUTHORIZATION_TYPE":"Basic","BASIC_AUTH_USER":"basicUserName","BASIC_AUTH_PASSWORD":"$3cr3t_p@55w0rd"},"name":"scim","_links":{"self":{"href":"https://api.pingone.com/v1/environments/abfba8f6-49eb-49f5-a5d9-80ad5c98f9f6/propagation/stores/a7115f69-136d-4b5d-8b24-5c1c218147f5"}}}]}}