Change requests

Change requests

In order to request changes there there are new endpoints to create, query or rejects change requests.

Create change request

Create a change request with a POST containing path-updates similar to the merge endpoint. The structure is flattened metaData, but can also top-level data attributes like entityid or allowedall.

POST: /manage/api/internal/change-requests
{
  "metaDataId" : "1",
  "type" : "saml20_sp",
  "pathUpdates" : {
    "allowedall": true,
    "metaDataFields.description:en" : "New description",
    "metaDataFields.name:nl" : "Nieuwe naam"
  },
  "auditData" : {
    "user" : "jdoe"
  },
  "note": "Optional note describing the reason for this change"
}

The auditData part is required, but the value can be either urn, name, email etc. The note is optional, but recommended. If the value of a property in the pathUpdates dictionary is null then it will be removed.

Get all outstanding change requests

To retrieve all outstanding change requests for an entity you must specify the ID of the entity and the type of the entity as path parameters:

GET: /manage/api/internal/change-requests/saml20_sp/1
[
{
  "id" : "620f904ab451045ee60eda74",
  "metaDataId" : "1",
  "type" : "saml20_sp",
  "pathUpdates" : {
    "metaDataFields.description:en" : "New description",
    "metaDataFields.coin:application_url" : "https://nice"
  },
  "auditData" : {
    "user" : "jdoe",
    "userName" : "sp-portal",
    "apiUser" : true
  },
  "note": "Optional note describing the reason for this change"
  "created" : "2022-02-18T12:25:46.032Z",
  "metaDataSummary" : {
    "organizationName" : "Organization name en",
    "name" : "OpenConext Valid SP",
    "entityid" : "Duis ad do",
    "state" : "testaccepted"
  }
}]

The metaDataSummary is used by the Manage GUI and can be ignored.

Reject

Rejecting a change request requires the ID of the change request, the ID of the entity and the type of the entity.

PUT: /manage/api/internal/change-requests/reject
{
   "id" : "620f904ab451045ee60eda74",
   "metaDataId": "1",
   "type": "saml20_sp"
}

Accept

Accepting a change request is not possible with this API. Change requests can only be accepted in the Manage GUI.