Skip to content
Authrim

Deactivate a field mapping version.

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

Deactivates an active field mapping version and returns a lifecycle transition result envelope. Refused while the version in use is named (see references): a default, an app, a SAML provider, a federation trust source, a credential profile or SCIM names the set (reason referenced), or where it is used could not be checked everywhere (scan_incomplete). Deactivating a version that is not in use is not refused. A version that is not one of this set answers 404.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
fieldMappingSetId
required
string

Field mapping set identifier.

fieldMappingVersionId
required
string

Field mapping version 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 ”

Lifecycle transition response.

Media type application/json
object
result
required
object
id
required
string
tenantId
string
fieldMappingSetId
string
fieldMappingVersionId
string
lifecycleState
required
string
reviewedAt
integer
activatedAt
integer
publishedAt
integer
deactivatedAt
integer
key
additional properties
key
additional properties
Example generated
{
  "result": {
    "id": "example",
    "tenantId": "example",
    "fieldMappingSetId": "example",
    "fieldMappingVersionId": "example",
    "lifecycleState": "example",
    "reviewedAt": 1,
    "activatedAt": 1,
    "publishedAt": 1,
    "deactivatedAt": 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"
}