Integrations

Restore integration to last successful mapping

This route restores an Ocean-based integration's mapping to the last configuration that was part of a successful resync, and triggers a resync using that restored mapping.<br/><br/>This is useful for reverting an unwanted or broken mapping change, without having to manually reconstruct the previous configuration.<br/><br/>To learn more about configuring mappings, check out the documentation.<br/><br/>Permission requirements<br/>To use this endpoint, you must have a moderator or admin role in your Port organization.<br/>To learn more about the different roles and permissions, please refer to the documentation.

post/v1/integration/{integration_id}/restore

Request

  • Base URL: https://api.port.io
  • URL: https://api.port.io/v1/integration/{integration_id}/restore
  • Auth: API key in header Authorization

Path parameters

integration_idstring required

The unique identifier of the integration you want to resync.

Request body

trigger'manual' | 'apply_mapping' required

Determines how the restored mapping is applied. manual patches the restored config directly onto the integration. apply_mapping applies the restored config through the same path used when a mapping change is applied from the UI.

Response

Default Response

okboolean required
triggeredAction'manual' | 'apply_mapping' required

Determines how the restored mapping is applied. manual patches the restored config directly onto the integration. apply_mapping applies the restored config through the same path used when a mapping change is applied from the UI.

Changes

No recorded changes to this operation across all 1 revision of this API.