Skip to content
Authrim

Rollback a field mapping set.

POST
/api/admin/field-mapping/field-mapping-sets/{fieldMappingSetId}/rollback
Code sample: Shell / cURL 
curl --request POST \
  --url https://auth.example.com/api/admin/field-mapping/field-mapping-sets/example/rollback \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

Rolls back a field mapping set to a previous active state according to the repository policy and returns rollback metadata. Refused with 409 (reason referenced) while a default (the platform’s or a tenant’s), an app, a SAML provider, a credential profile or SCIM still names the set (a rollback re-activates an earlier activation whose compiled snapshot is not active), or with 409 (reason scan_incomplete) when where it is used could not be checked everywhere. references carries the count, the first references, and for a platform set the count of other tenants’ references; their tenant and app IDs are given only to a caller with global authority. Also 409 (reason would_break_references) when the version would not meet what the references need.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
fieldMappingSetId
required
string

Field mapping set identifier.

Header Parameters

Section titled “Header Parameters ”
Idempotency-Key
string

Idempotency key for state-changing operations that support replay protection.

Request Body

Section titled “Request Body ”
Media type application/json
object
key
additional properties
Example 
{}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Field mapping rollback response.

Media type application/json
object
result
required
object
id
required
string
tenantId
required
string
fieldMappingSetId
required
string
fieldMappingVersionId
required
string
lifecycleState
required
string
rolledBackAt
required
integer
key
additional properties
key
additional properties
Example generated
{
  "result": {
    "id": "example",
    "tenantId": "example",
    "fieldMappingSetId": "example",
    "fieldMappingVersionId": "example",
    "lifecycleState": "example",
    "rolledBackAt": 1
  }
}

400

Section titled “400 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Section titled “401 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Section titled “403 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

404

Section titled “404 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

409

Section titled “409 ”

The change was refused: the Mapping Set is named somewhere (referenced), the version would not meet what the references need (would_break_references), or where it is used could not be checked everywhere (scan_incomplete).

Media type application/json
object
error
required
string
Allowed values: conflict
error_description
required
string
reason
required
string
Allowed values: referenced scan_incomplete would_break_references
references
required
object
count
required

Everything found, other tenants’ included.

integer
countIsLowerBound
required

True when a place held more rows than were read.

boolean
items
required

The first references the caller may see in full.

Array<object>
object
kind
required
string
Allowed values: platform_default tenant_default client saml_provider credential_profile federation_trust_source scim
tenantId

The tenant the reference is in. Absent for the platform’s own default.

string
clientId
string
providerId
string
providerType
string
entityId

The entity ID of the SAML partner the provider is configured for.

string
profileId
string
versionId
string
versionLifecycleState
string
credentialConfigurationId
string
trustSourceId

A federation trust source whose runtime resolution names the set.

string
federationRole
string
Allowed values: saml_idp saml_sp
role
string
Allowed values: issuance verification
pinnedVersionId

A Mapping Set version the reference pins.

string
pinnedSnapshotHash

The compiled snapshot a credential profile version was published with.

string
viaMappingSetId

When asked about a Destination Profile, the Mapping Set the reference is through.

string
key
additional properties
itemsTruncated
required
boolean
otherTenants

References in other tenants the caller may not see, as counts only.

object
referenceCount
required
integer
tenantCount
required
integer
scanned
required

False when the other tenants’ Core databases were not read (the caller has no global authority): the counts then hold only what the Admin database knows.

boolean
key
additional properties
scanComplete
required
boolean
unscanned
required
object
count
required
integer
items
required
Array<object>
object
area
required
string
Allowed values: platform_settings tenant_settings credential_profiles federation_trust_sources tenant_clients tenant_saml scim_settings tenant_directory tenant_limit other_tenants
tenantId

Given only for the caller’s own tenant, or to a caller with global authority.

string
reason
required

A fixed code (for example core_database_unavailable, no_such_table).

string
key
additional properties
key
additional properties
violation

Only on would_break_references, the condition the version would fail.

object
code
string
Allowed values: destination_profile_invalid platform_set_unsafe snapshot_inactive pinned_version_replaced activation_scope_mismatch saml_destination_policy_mismatch saml_attribute_descriptor_renames_field
message
string
key
additional properties
key
additional properties
key
additional properties
Example 
{
  "error": "conflict",
  "reason": "referenced",
  "references": {
    "items": [
      {
        "kind": "platform_default",
        "federationRole": "saml_idp",
        "role": "issuance"
      }
    ],
    "unscanned": {
      "items": [
        {
          "area": "platform_settings"
        }
      ]
    },
    "violation": {
      "code": "destination_profile_invalid"
    }
  }
}

500

Section titled “500 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}