Skip to content

Delete a site contact

DELETE
/v1/clients/{clientId}/sites/{siteId}/contact-persons/{id}
curl --request DELETE \
--url https://api2.recruso.co.uk/v1/clients/1/sites/1/contact-persons/1 \
--header 'Authorization: <Authorization>'

Deletes one contact person from one of your own agency’s sites. This is a soft delete: the row is retained with its activities and cost-centre links, and RestoreSiteContactPerson can bring it back.

A deleted contact disappears from ListSiteContactPersons and from GetSiteContactPersonById, which returns 404 for it. Restore is the only way to read it again, so record the contactPersonId before deleting.

Contact names are not reserved — another contact can immediately take the same name.

The site must belong to the client named in the route, and the contact to that site; otherwise 404. Deleting an already-deleted contact also returns 404.

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

clientId
required
integer format: int32

The clientId path parameter

siteId
required
integer format: int32

The siteId path parameter

id
required
integer format: int32

The id path parameter

No Content

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"
}