Update a bank holiday

PUT

/v1/bank-holidays/{id}

curl --request PUT \
  --url https://api2.recruso.co.uk/v1/bank-holidays/1 \
  --header 'Authorization: <Authorization>' \
  --header 'Content-Type: application/json' \
  --data '{ "bankHolidayDate": "2026-04-15" }'

• Production

Updates one of your agency’s bank holidays. These are the UK bank holiday dates. Recruso supplies them and refreshes them each year from the government’s list, and hours worked on one are expected to be paid at the bank holiday rate.

Send the complete record: the fields you supply replace the stored values.

Names are not checked for uniqueness.

You only ever see and change your own agency’s records; there is no owner id on the request, and an id belonging to another agency returns 404 rather than 403 so that its existence is never disclosed.

Access. Requires a client-credentials access token. Tokens issued through the interactive user login are rejected.

Authorizations

• Bearer

Parameters

Path Parameters

id

required

integer format: int32

The id path parameter

Request Body^required

Media typeapplication/json

object

bankHolidayDate

required

string format: date

Example^generated

{
  "bankHolidayDate": "2026-04-15"
}

Responses

200

OK

Media typeapplication/json

object

bankHolidayId

required

integer format: int32

bankHolidayDate

required

string format: date

Example^generated

{
  "bankHolidayId": 1,
  "bankHolidayDate": "2026-04-15"
}

400

Bad Request

Media typeapplication/problem+json

object

type

string

nullable

title

string

nullable

status

integer format: int32

nullable

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

401

Unauthorized

Media typeapplication/problem+json

object

type

string

nullable

title

string

nullable

status

integer format: int32

nullable

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

403

Forbidden

Media typeapplication/problem+json

object

type

string

nullable

title

string

nullable

status

integer format: int32

nullable

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}

404

Not Found

Media typeapplication/problem+json

object

type

string

nullable

title

string

nullable

status

integer format: int32

nullable

detail

string

nullable

instance

string

nullable

Example^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example"
}