Skip to main content
Feedback

Post Reset Agreements

The Post Reset Agreements operation deletes field-level source agreements for individual records. This unblocks updates when records are stuck due to prior ranking exceptions or removed sources.

Basic authentication

To perform this operation using Basic auth, send an HTTP POST request to:

https://<base URL>mdm/universes/{universeId}/records/{recordId}/resetAgreements

where base URL is the URL for your Hub cloud that hosts your repository.

JWT authentication

To perform this operation using JSON Web Token (JWT) authentication, send an HTTP POST request to:

https://<base URL>mdm/universes/{universeId}/records/{recordId}/resetAgreements?repositoryId=<repository ID>

You must have the following MDM privileges:

  • Edit Records entitlement.

Path parameters

universeId Universe ID

recordId Record ID

Query parameters

repositoryId
ID of the repository. Case sensitive. Required with JWT authentication only. You can obtain the repository ID from the URL after navigating to the repository in the user interface.

Request body

The request body is empty.

Response

  • 200 (OK) Agreements reset.

  • 400 (Bad Request) System previously reset the request record. Sample response body:

    <error>
      <message>System previously reset the requested record ranking.</message>
    </error>

  • 400 (Bad Request) Request Universe does not have any ranked fields. Sample response body:

    <error>
      <message>Requested Universe does not have any ranked fields.
    </message>
    </error>

  • 400 (Bad Request) Source ranking is not enabled for the account. Sample response body:

    <error>
      <message>Source ranking is not enabled for the account.</message>
    </error>

  • 400 (Bad Request) The universeID parameter value contains only space characters. Sample response body:

    <error>
      <message>The given universe id is blank.</message>
    </error>

  • 401 (Invalid Credentials) JWT auth token is expired. Sample response body:

    <error>
      <message>Problem accessing /mdm/universes. Reason: Invalid credentials</message>
    </error>

  • 403 (You do not have permissions to access this resource) User does not have the required MDM privilege to perform the action. Applicable to JWT auth only. Sample response body:

    <error>
      <message>You do not have permissions to access this resource.</message>
    </error>
On this Page