---
title: "Set the date on which to revoke ESS access"
method: PATCH
path: "/v2/providers/employers/employees/{employeeId}/revokeEmployeeSelfServiceAccess"
tags: ["Employee"]
---

# Set the date on which to revoke ESS access

`PATCH /v2/providers/employers/employees/{employeeId}/revokeEmployeeSelfServiceAccess`

## Request

- Base URL: `https://api.loket.nl`
- URL: `https://api.loket.nl/v2/providers/employers/employees/{employeeId}/revokeEmployeeSelfServiceAccess`
- Auth: none required

__Activity name :__ <a href="https://developer.loket.nl/Activities/PatchRevokeEmployeeSelfServiceAccessByEmployeeId" target="_blank">PatchRevokeEmployeeSelfServiceAccessByEmployeeId</a>

This endpoint allows the user to set the 'revokeEmployeeSelfServiceAccessOn'. This date indicates on what day the access to WerknemerLoket (Employee Self Service) will be revoked (this is done by scheduled tasks that run during the night). This is particularly useful for situations where for example the employer wants to restrict access at a specific date in the future, for example 1st of May in the next year.

The value may be set to NULL and thus clearing the date on which access would be revoked. Please note that this endpoint will not automatically 'unblock' an Employee, as that would require a specific action.

## Path parameters

- `employeeId` string, uuid, required

## Headers

- `Authorization` string, required
- `Accept` string, required

## Request body

- RevokeEmployeeSelfServiceAccess
  - `revokeEmployeeSelfServiceAccessOn` string, date, nullable: The date on which the Employees access to ESS (werknemer.loket) will be automatically revoked.

## Response `200`

OK

- object: a warning indacateds that the given payload is valide, however take notice of the warning this might ifluence behavour.
  - `version` Version
    - `obsoleteDate` string, date, nullable: The date (can be null) on which the `resourceVersion` is no longer supported/available
    - `resourceVersion` string, date: The resource version of the object in the response
  - `messages` object[]
    - `type` string: Indication of the type of message. See [the general documentation for more information](./#section/Response/Messages)
    - `description` string: Describes the message
    - `id` string, uuid, nullable: In some cases when the message may relate to a specific entity, or specific group of entities, this field provides the identifier of that entity
    - `code` integer: Identifying code for the message
    - `properties` string[]: An array that can contain additional information
  - `content` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/loket/apis/loket-api.md) - [All operations](https://skmtc.dev/loket/apis/loket-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loket/apis/loket-api/revisions/32170564148f?raw)