Marking as processed

When you have retrieved data, it is possible to mark it as processed via the entity-access endpoint. This will allow you to check if this data has already been retrieved in the past.

Doing so will make it easier for you to keep track of how much of your data you have already received through our API.

It will also allow you to easily link entities between your system and TapRaise by setting the consumerIdentifier.

POST/api/v1/entity-access/actions/mark-processed

Authorization

bearer

Body

application/json

entries*array of MarkEntitiesAsProcessedInputEntry (object)

List of entities to mark as processed

Response

204400401403

Entities were marked as processed. No response body.

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/entity-access/actions/mark-processed', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer jwt",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "entries": [
        {
          "entityName": "person",
          "entityUuid": "82b431f0-f401-4afd-b6db-9d1d751232d9",
          "processedAt": "2023-05-01T00:00:00.000Z"
        }
      ]
    }),
});
const data = await response.json();

Response

400

{
  "errors": [
    {
      "entityName": "text",
      "entityUuid": "123e4567-e89b-12d3-a456-426614174000",
      "consumerIdentifier": "text",
      "errorMessage": "text"
    }
  ]
}