Skip to content

Remove one of a worker's availability entries

DELETE
/v1/workers/{workerId}/availability/{availabilityId}
curl --request DELETE \
--url https://api2.recruso.co.uk/v1/workers/1/availability/1 \
--header 'Authorization: <Authorization>'

Removes an availability entry of a worker in your own agency, which makes the worker available again on that date: no “available” entry is written in its place.

The entry must be dated no more than 20 days before today and no more than a year after it, and must hold one of your agency’s statuses and not one that affects a worker’s AWR parity; otherwise the request returns 400 and the entry stays.

An entry that belongs to a different worker returns 404, as does a worker in another agency, under a branch the Recruso user behind your API app cannot reach, or deleted under data-protection law — never 403, so existence is never disclosed.

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

workerId
required
integer format: int32

The workerId path parameter

availabilityId
required
integer format: int32

The availabilityId path parameter

No Content

Bad Request

Media typeapplication/problem+json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Unauthorized

Media typeapplication/problem+json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Forbidden

Media typeapplication/problem+json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Not Found

Media typeapplication/problem+json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}